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Note to all users: 



All options and values that were valid on the JCL EXEC statement, the lOCP 
command, and the menu screens in previous levels of lOCP are still valid. 

If your processor complex has only two I/O configuration data sets, the following 
changes apply throughout this manual: 

• There are only two I/O configuration data sets, the LVLO lOCDS and the LVLl 
lOCDS. When the manual refers to the AO lOCDS, this is the LVLO lOCDS; 
the Al lOCDS is the LVLl lOCDS. Ignore all references to an A2, A3, and B 
side (BO, Bl, B2, and B3) lOCDS and to any options that contain AB (such as 
WRTCDS-ABx). 

• lOCP can write only to the LVLl lOCDS. 

• You select the active lOCDS and do a power-on reset from the CONFIG 
(SYS020) frame. Action A3 on the CONFIG frame switches the LVLO and 
LVLl lOCDS. Ignore all references to the lOCDSM (SYS021) frame. 

If your processor complex does not have a B side, ignore all references to the B side 
throughout the manual. This includes ignoring all references to: 

• The BO, Bl, B2, and B3 lOCDS 

• Options that contain AB (such as WRTCDS = ABx) 

• Processors 1 and 3 

• Channel paths 40 through 47, 50 through 57, and 60 through 67 

If you have a 3084 Processor Complex, it must be configured as a multiprocessor for 
the options that contain AB (for example REPORT = AB) to be executed. B side 
options cannot be executed on the A side of a physically partitioned 3084 Processor 
Complex; while A side options cannot be executed on the B side of a physically 
partitioned 3084 Processor Complex. 
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Preface 



Trademarks 



This book describes the input/output configuration program (lOCP) used to define 
I/O configuration data required by the processor complex to control I/O requests. 
This book does not include information on how to configure I/O resources, only on 
how to define the configuration via lOCP. 

This book describes the MVS version, the VM version, and the stand-alone version 
of lOCP. The VM version of lOCP means that version of lOCP that runs under all 
releases of the following operating systems: VM/System Product (5664-167), 
VM/System Product High Performance Option (5664-173), and the VM/Extended 
Architecture Systems Facility (VM/XA) (5664-169). 



The following are trademarks of International Business Machines Corporation. 

• MVS/SP™ 

• MVS/XA™ 

• VM/XA™ 



Who Should Read This Book 

This book is intended for system programmers and customer engineers who are 
responsible for defining, instaUing, and configuring the channels, control units, and 
I/O devices on the processor complexes Hsted on the cover of this manual. It 
assumes the reader has a knowledge of the appropriate processor complex and the 
characteristics of its I/O resources. 

Note that where the term "processor complex" appears in this manual, all the processor 
complexes listed on the cover are implied, unless an exception is explicitly made at that 
point in the text. The term "uniprocessor" in this manual refers to a processor 
complex that physically contains only one processor. 

How This Book Is Organized 

You will find the following topics presented in this book: 

Chapter 1. Introduction - presents an overview of the input/output configuration 
program (lOCP) and the I/O configuration process. 

Chapter 2. Executing the MVS Version of lOCP - describes how to code lOCP 
macro instructions and how to execute lOCP under control of the MVS system 
control program (MVS/370 or MVS/XA). 

Chapter 3. Executing the VM Version of lOCP - describes how to code lOCP macro 
instructions and how to execute lOCP under control of the VM/SP, the VM/SP 
High Performance Option or the VM/XA Systems Facihty system control program. 

Chapter 4. Executing the Stand-Alone Version of lOCP - describes how to execute 
lOCP from the system console or the service support console. 
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Chapter 5. lOCP Configuration Reports - shows the configuration reports that lOCP 
produces. 

Chapter 6. lOCP Messages - lists the messages (prefix ICP and DMSICP) that lOCP 
issues. 

Appendix A. Coding lOCP Macro Instructions - describes the rules for coding lOCP 
macro instructions and the notation used in this book to illustrate the syntax of the 
macro instructions. 

Appendix B. Listings of Macro Instruction Input - shows sample listings of lOCP 
input decks. 

Appendix C. Characteristics of the I/O Interface Timeout Function - contains detailed 
information about the timeout function. 

Appendix D. A Sample List of I/O Devices and Control Units - shows the lOCP 
parameter values that you specify on the lODEVICE and CNTLUNIT macro 
instructions. 

Glossary of Terms and Abbreviations - defines some terms and abbreviations used in 
this book. 



Where You Can Find Additional Information 

The following publications contain information for topics related to lOCP. 

Processor Complexes 

IBM System/370 InputJOutput Configurator, GA22-7002, lists the devices available 
on the System/370 processors. 

IBM 3081 Functional Characteristics, GA22-7076, provides an overview of the 3081 
Processor Complex. 

IBM 3083 Functional Characteristics, GA22-7083, provides an overview of the 3083 
Processor Complex. 

IBM 3084 Functional Characteristics, GA22-7088, provides an overview of the 3084 
Processor Complex. 

IBM 3081 and 3083 Channel Characteristics and Configuration Guide, GA22-7077, 
provides information about channel operations and guidehnes for configuring 
channel loads. 

IBM 3081 Operator's Guide for the System Console, GC38-0034, describes how to 
operate the 3081 Processor Complex. 

IBM 3083 Operator's Guide for the System Console, GC38-0036, describes how to 
operate the 3083 Processor Complex. 

IBM 3084 Operator's Guide for the System Console, GC38-0037, describes how to 
operate the 3084 Processor Complex. 
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MVS/370 



MVS/XA 



IBM 3081. 3083, and 3084 Messages for the System Console, GC38-0035, lists and 
defines the messages that are displayed during operation of the system console. 

IBM 9081 and 9083 RPQ Information Supplement, GL22-7086, is a supplement for 
the 9081 and 9083 Processor Complexes to IBM 3083 Functional Characteristics and 
IBM 3081 and 3083 Channel Characteristics and Configuration Guide. 

IBM 9081 and 9083 RPQ Operator Information Supplement, GL22-7087, is a 
supplement for the 9081 and 9083 Processor Complexes to IBM 3083 Operator's 
Guide for System Console and IBM 3081, 3083 and 3084 Messages for System 
Console 



0S/VS2 MVS/System Product General Information Manual, GC28-1025, describes 
the MVS system requirements for MVS/System Product Version 1 (Program 
Numbers 5740-XYS and 5740-XYN). 

0S/VS2 System Programming Library: System Generation Reference, GC26-3792, 
provides information necessary to install an MVS/370 system control program. 

0S/VS2 MVS JCL, GC28-0692, contains the information necessary to code 
MVS/370 job control language statements. 



MVS/System Product Version 2 Release 1 General Information, GC28-1118, describes 
the MVS system requirements for MVS/System Product Version 2 (Program 
Numbers 5740-XC6 and 5665-291). 

MVS/System Product Version 2 Release 2 General Information, GC28-1500, describes 
the MVS system requirements for MVS/System Product Version 2 (Program 
Numbers 5740-XC6 and 5665-291). 

Data Facility Product: General Information, GC26-4142, (Program Number 
5665-0284) describes the system generation requirements for MVS/System Product 
Version 2. 

MVS/Extended Architecture Installation: System Generation, GC26-4148, provides 
information necessary to install an MVS/XA system control program. 

MVS/Extended Architecture: MVS Configuration Program Guide and Reference, 
GC28-1335, provides information necessary to use the MVS configuration program 
for releases of MVS/SP 2.2.0. 

MVS/Extended Architecture JCL Reference, GC28-1352, contains the information 
necessary to code MVS/XA job control language statements. 

MVS/Extended Architecture JCL User's Guide, GC28-1351, describes the job control 
tasks needed to enter jobs into the operating system. 
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VM/SP 

IBM Virtual Machine! System Product General Information, GC20-1838, describes the 
features of the IBM Virtual Machine/System Product (VM/SP) Program Product 
and includes a hst of devices supported by VM/SP. 

IBM Virtual Machine! System Product: Planning Guide and Reference, SCI 9-6201, 
describes information about generating a VM/SP system on a processor complex. 

IBM Virtual Machine! System Product: Installation Guide SC24-5237, provides 
procedural information about the VM/SP installation process. 

IBM Virtual Machine ! System Product: System Programmer' s Guide, SC19-6203, 
describes the DIAGNOSE X'80' instruction, which is the CP (control program) 
interface that allows you to read from and write to the I/O configuration data sets in 
the processor controller. 

VM/SP High Performance Option (VM/SP HPO) 

IBM Virtual Machine! System Product High Performance Option General Information 
Manual, GC19-6221, describes the features of the VM/SP HPO Program Product 
and includes a Hst of devices supported by VM/SP HPO. 

IBM Virtual Machine! System Product High Performance Option: Planning and 
System Generation Guide, SCI 9-6223, describes information about generating a 
VM/SP HPO system on a processor complex. 

IBM Virtual Machine! System Product High Performance Option: System 
Programmer's Guide, SCI 9-6224, describes the DIAGNOSE X'80' instruction, which 
is the CP (control program) interface that allows you to read from and write to the 
I/O configuration data sets in the processor controller. 

VM/XA Systems Facility 

Virtual Machine! Extended Architecture Systems Facility General Information Manual, 
GC19-6213, describes the features of the VM/XA Systems Facility. 

Virtual Machine! Extended Architecture Systems Facility: Installation, Administration, 
and Service, GC19-6217, describes information about generating a VM/XA system 
on a processor complex. 

Do You Have Problems, Comments, or Suggestions? 

Your suggestions and ideas can contribute to the quality and the usability of this 
book. If you have problems using this book, or if you have suggestions for 
improving it, complete and mail the Reader's Comment Form found at the back of 
the book. 
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Summary of Changes 



Summary of Changes 
for GC28-1027-7 

This book incorporates changes that support control units capable of running at 4.5 

megabytes. 



Summary of Changes 
for GC28-1027-6 

This book incorporates two new options for the lOCP Command which include: 

• The WRTABx write option for generating an lOCDS. 

• The RPTAB option for producing configuration reports. 

The book also incorporates changes due to the MVS Configuration Program 
(MVSCP). MVSCP replaces the SYSGEN process in releases of MVS SP 2.2.0 or 
later. 

There are also minor technical and editorial changes. 



Summary of Changes 
for GC28-1027-5 

Changes throughout this publication describe a new level of the input/output 
configuration program (lOCP) to support: 

• A change in the VM lOCP command. The VM lOCP command now supports a 
processor option. 

• An added step for starting the stand-alone version of lOCP. 
There are also minor technical and editorial changes. 
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Chapter 1. Introduction 



In the processor complex' the channel subsystem, which controls channel operations, 
requires specific data about the hardware I/O configuration. 

To define the I/O configuration for the channel subsystem, you execute the 
input/output configuration program (lOCP). Required in this definition are the: 

• Channel paths on the processor complex 

• Control units attached to the channel paths 

• I/O devices assigned to the control units 

To meet your changing I/O requirements, you can replace an existing I/O 
configuration with a new configuration by executing lOCP. 

Figure 1-1 and Figure 1-2 show the processors and cl#nnel paths that are available 
on each side of a processor complex. All of the processor complexes have side A. 
Side A may consist of processors and 2 and channel paths 00 through 07, 10 
through 17, and 20 through 27. (A uniprocessor has only processor 2.) If the 
processor complex has both side A and side B, side B consists of processors 1 and 3 
and channel paths 40 through 47, 50 through 57, and 60 through 67. 

The control units and I/O devices attached to the channel paths complete the 
channel subsystem. You must use lOCP to define all control units and I/O devices 
that attach to the processor complex. 

See the IBM System/SJO Input/Output Configurator for the control units and I/O 
devices available. Your operating system may not support all the devices lOCP 
supports. 

This chapter presents an overview of the following topics: 

• I/O configuration process 

• Input/output configuration data set (lOCDS) 

• lOCP changes for 370-XA mode 

• Versions of lOCP (MVS, VM,2 and stand-alone) 



1 Note that where the term "processor complex" appears in this manual, the term implies all the processor complexes 
listed on the cover of this manual, unless at that point, the text makes an explicit exception. 

2 "The VM version of lOCP" means that version of lOCP that runs under all releases of the following operating 
systems: VM/System Product (5664-167), VM/System Product High Performance Option (5664-173), and the 
VM/Extended Architecture (VM/XA) Systems Facility (5664-169). 
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Figure 1-1. Channel Path Configuration for a non-3084 Processor Complex 
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I/O Configuration Process 

You specify I/O configuration data to lOCP in either of two ways: coding the data 
on card-image macro instructions read from an input device, or entering the data 
from the system console or service support console. In either situation, lOCP 
performs the same process to build a configuration definition in storage and to write 
reports. lOCP stores the data in an input/output configuration data set (lOCDS) on 
the processor controller file in the processor controller for use by the channel 
subsystem. 

Card-Image Input to lOCP 

You code the following card-image macro instructions and use them to define your 
I/O configuration data when you execute (1) the MVS version of lOCP, (2) the VM 
version of lOCP, or (3) the stand-alone version of lOCP with the card-image option. 
When lOCP processes these macro instructions, it also produces reports that allow 
you to check the configuration. 

Macro Instruction Description 

ID An optional macro instruction that specifies identification 

information printed in the heading of lOCP configuration 
reports. It is also the source of the customer name for the 
lOCDS on the lOCDSM frame. 

CHPID A required macro instruction that specifies the channel paths 

installed on the processor complex. 

CNTLUNIT A required macro instruction that specifies the control units 

attached to channel paths. 

lODEVICE A required macro instruction that specifies the I/O devices 

assigned to control units. 

"Specifying lOCP Macro Instructions" in Chapter 2 (MVS) and Chapter 3 (VM) 
fully describes the lOCP macro instructions 

Console input to lOCP 

When you execute the stand-alone version of lOCP, lOCP displays menus on the 
display screen of the system console or the service support console. On the screen, 
you enter I/O configuration data and lOCP screen commands to control the 
functions of lOCP. For a full description of the stand-alone version of lOCP, see 
"Chapter 4. Executing the Stand- Alone Version of lOCP". 
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I/O Configuration Data Sets 



Each side of the processor complex has four input/output configuration data sets for 
storing I/O configuration data. On the A side, the lOCDS names are AO, Al, A2, 
and A3. On the B side, the lOCDS names are BO, Bl, B2, and B3. The data sets 
reside on an integrated processor controller file in the processor complex. Each 
lOCDS consists of 256-byte records (sectors) containing I/O configuration data. The 
channel subsystem uses the I/O configuration data to control I/O requests. Each 
side provides four I/O configuration data sets to allow you to define and test new 
configurations without affecting an existing configuration. 

lOCP processes your definitions of channel paths, control units, and I/O devices in a 
working area of main storage named lOCDS. When you request, and if lOCP has 
found no errors, lOCP writes the lOCDS generated in storage to an lOCDS in the 
processor controller. 

lOCP accesses and transforms the configuration data in the lOCDS to a data format 
that the microcode in the channel subsystem uses when you perform either of the 
following actions: 

• A power-on reset -- acfion A2 on the CONFIG (SYS020) frame 

• The SYSIML CLEAR function -- action 08 on the OPRCTL (CC-010 or 
CC/010) frame 

(For more information, see the operator's guide for the system console that applies 
to your processor complex.) The channel subsystem controls I/O requests using the 
configuration data from the lOCDS specified for the power-on reset. 

lOCP can read from any lOCDS (for example, to produce reports). However, lOCP 
can write only to an lOCDS not write-protected. 

You can write-protect each lOCDS individually by using the lOCDSM (SYS02I) 
frame. This restricfion prevents you from accidentally using lOCP to write over and 
destroy the configuration data in an lOCDS. Before writing an lOCDS, you must 
use the lOCDSM frame and remove the write protection from that lOCDS. (For 
more information, see the operator's guide for the system console that a:pplies to 
your processor complex.) 

When defining a new configuration, you can: 

• Use the configuration in an existing lOCDS as your operating configuration. 

• Execute lOCP to generate and write a new I/O configuration to another lOCDS. 

• Perform a power-on reset and use the new configuration to test the system. 

• After successful testing, you can write-protect the new lOCDS by using the 
lOCDSM (SYS021) frame. 

If your processor complex has only two I/O configuration data sets (LVLO and 
LVLl), switch the LVLO and LVLl lOCDS after successful testing by using the 
CONFIG (SYS020) frame. The newly tested configuration now resides in the LVLO 
lOCDS and the previous configuration resides in the LVLl lOCDS. The LVLl 
lOCDS provides a backup. You can use the LVLl lOCDS to test another new 
configuration. 
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Notes; 

1 . If you partition a processor complex with an A and B side, you can use an 
lOCDS that has I/O configuration data for both the A and B sides. However, 
the processors cannot access control units and devices attached only to channel 
paths on the other side. 

2. If available during the installation of the new processor complex, the CE uses a 
card-image input deck containing lOCP macro instructions (prepared and 
checked by the installation) to configure the processor complex. The CE then 
tests the processor complex using the configuration supplied by the installation. 
The methods of execution in Chapter 2 (MVS), Chapter 3 (VM), and Chapter 4 
(stand-alone) describe the steps that the CE and the installation perform to 
define configuration data. 

3. If your processor complex has an A and B side, you should define critical 
configurations on both A and B side lOCDS(s). 

Levels of the lOCDS 

The processor complex can operate in either 370 mode or 370-XA mode. You select 
the mode on the CONFIG (SYS020) frame. Power-on reset sets the mode. 

In 370 mode, the processor complex operates in accordance with System/370 
architecture, the hardware architecture that the processor complex shares with other 
IBM processors, such as the IBM 303x processors and the IBM 4300 processors. 
One major characteristic of 370 mode is 24-bit addressing. 

In 370-XA mode, the processor complex operates in accordance with System/370 
Extended Architecture. Two main characteristics of 370-XA mode are 31 -bit 
addressing and the use of a channel subsystem to direct the flow of information 
between I/O devices and main storage. 

This book describes the 370/370-XA level of lOCP, which creates an lOCDS that 
either 370 mode or 370-XA mode can use (a 370/370-XA lOCDS). Some previous 
levels of lOCP (370 lOCP) created an lOCDS for use only in 370 mode (a 370 
lOCDS). A 370/370-XA lOCP creates a 370/370-XA lOCDS regardless of the mode 
of the processor complex at power-on reset. 

A processor complex can use a 370/370-XA lOCDS in either 370 mode or 370-XA 
mode. If you do not specify the channel number and channel set for a channel path 
on the CHPID macro instruction, the processor complex cannot access the devices 
on that channel path when operating in 370 mode. 

Most of the information on the lOCP macro instructions applies to both 370 mode 
and 370-XA mode. When the processor complex operates in 370-XA mode, it 
ignores information valid only for 370 mode. Similarly, when the processor complex 
operates in 370 mode, it ignores information vaUd only for 370-XA mode. 
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Compatibility Considerations 

Before you can initialize a processor complex (by a power-on reset) in 370-XA mode, 
lOCP must generate a 370/370-XA lOCDS. The lOCP generation process requires 
as input an I/O configuration deck containing lOCP macro instructions. (You can 
use a combined input deck containing both lOCP, MVS system generation macro 
instructions and MVS Configuration program (MVSCP) macro instructions. None 
of IBM's VM operating systems allow a combined deck.) To generate a 370/370-XA 
lOCDS, you can use the 370/370-XA level of the stand-alone version of lOCP. You 
can also generate a 370/370-XA lOCDS by running the 370/370-XA level of lOCP 
under the control of MVS/370, MYS/XA, VM/SP, VM/SP HPO, or the VM/XA 
Systems Facihty. 

A 370 lOCDS does not support the operation of a processor complex in 370-XA 
mode. You cannot use a 370 level lOCP to read or produce reports of a 
370/370-XA lOCDS. (You also cannot use an older level 370/370-XA lOCP to read 
or produce reports of a 370/370-XA lOCDS produced by a newer level 370/370-XA 
lOCP.) If you attempt this operation, the system issues message ICP404I, indicating 
that the level of the lOCDS directory is invalid. 

Note: I/O configurations that are yaUd in 370 mode may be invalid in 370-XA 
mode. It is important to fully understand the concepts and requirements of logical 
control units. If the requirements for logical control units have not been met, it may 
be necessary to physically reconfigure a system. You must review the current 
configuration to insure that the configuration is valid for 370-XA mode. This is 
necessary even when running in 370 mode. 
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370-XA Mode 



Notes 



To create a 370/370-XA level lOCDS, you can use without change macro 
instructions coded to create a 370 level lOCDS. MVS/XA or the VM/XA Systems 
Facility might not support all of the defined devices. See MVS I Extended 
Architecture System Generation Reference, MVSjExtended Architecture: MVS 
Configuration Program Guide and Reference or the Virtual Machine! Extended 
Architecture Systems Facility: Installation, Administration and Service. Although you 
can use the same macro instructions, you might consider making the following 
changes: 

• If there are channel paths and attached devices that you want to access only in 
370-XA mode, remove the channel number and channel set for those channel 
paths from the CHPID macro instruction(s). lOCP requires a channel number 
and channel set only if you will access the channel path and its attached devices 
in 370 mode. 

• To use the preferred path in 370-XA mode, code the PATH parameter on the 
lODEVICE macro instruction. The channel subsystem attempts to use the 
preferred path to initiate I/O requests. The PATH parameter is optional and 
apphes only to 370-XA mode. The processor complex ignores the preferred path 
in 370 mode. 



• You can use, without change, the macro instructions coded for the 370 level of 
lOCP to create an lOCDS for 370-XA mode operation. However, you must 
generate a new 370/370-XA lOCDS (with a 370/370-XA level of lOCP) before a 
processor complex can operate in 370-XA mode. 

• For an MVS/370 system generation if you specified the PATH or UNIT ADD 
parameter the lODEVICE macro instruction, you cannot use a combined input 
deck (lOCP and MVS system generation macro instructions). 

• If you use the PATH parameter or the UNITADD parameter on an lODEVICE 
macro instruction, you must use a 370/370-XA lOCP to test an lOCP input deck 
in 370 mode. 

• MVS/370, VM/SP, and VM/SP HPO do not support operafion of the processor 
complex in 370-XA mode. 

The 370/370-XA lOCP produces reports that are different from the reports produced 
by a 370 lOCP. Some of the new terms that appear in the reports and that 370-XA 
mode uses are: 

• Logical control units 

• Preferred path 

• Rotation algorithm 

• Device number 

• Control unit type 
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Logical Control Units 

For 370-XA mode, the channel subsystem uses logical control units to represent a set 
of physical control units that physically or logically attach I/O devices in common. 
For example, the channel subsystem uses the logical control unit to estabUsh a queue 
for I/O requests for the devices associated with the attaching physical control units 
and to establish a channel path selection order for the attaching channel paths. 

lOCP builds logical control units from the information specified on the CNTLUNIT 
macro instructions. If a device attaches to more than one physical control unit, then 
those control units v^ill form part of (or the whole of) a logical control unit. lOCP 
builds a logical control unit for: 

• Each control unit with no devices or no devices shared with other control units. 

Note: Logical control units with no devices are listed at the end of the logical 
control unit report. The user should verify that the report accurately describes 
the user's configuration. 

• Each group of two to four control units that share devices between them. 

As it builds each logical control unit, lOCP assigns a unique hexadecimal identifier 
to the logical control unit. It also ensures that the logical control unit is valid, that 
it does not violate any of the following restrictions: 

• Maximum of four channel paths per system can attach to one logical control 
unit. 

• Each occurrence of a channel path counts as one channel path. 

• Maximum of four physical control units in one logical control unit. 

• A physical control unit can belong to only one logical control unit. 

• Physical control units within a logical control unit must all have the same 
characteristics (SHARED = Y, YB, or N; PROTOCL = D, S, or S4). 

• Maximum of 256 logical control units per system. 
Figure 1-3 shows examples of vahd logical control units. 
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Figure 1-3. Valid Logical Control Units 
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Figure 1-4 shows examples of invalid logical control units. 

Logical control unit 5 is invalid because the control units have a combined total of 
more than four channel paths. Logical control unit 3 in Figure 1-3 would become 
invalid if you attached another physical control unit to any of the devices in the 
logical control unit. 

Logical control unit 6 is invalid also because the combined total of channel paths is 
six and the maximum permitted is four. (Each occurrence of a channel path counts 
as one channel path.) 

The logical control unit report (See "Chapter 5. lOCP Configuration Reports") 
describes the logical control unit structure. If it detects any invalid logical control 
units, lOCP issues error messages. 
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Figure 1-4. Invalid Logical Control Units 
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Channel Path Selection 



Preferred Path 



In 370-XA mode, the channel subsystem attempts to use the preferred path, if 
specified, for the initiation of I/O requests. If the preferred path is busy or is not 
specified, the channel subsystem uses the rotation algorithm (for the associated 
logical control unit) to initiate I/O requests. 



The optional PATH parameter on the lODEVICE macro instruction and the ADD 
and the ALTER I/O device screens allows you to specify a preferred path for 
370-XA mode. When the processor complex is operating in 370 mode, the channel 
subsystem ignores the preferred path. When the processor complex is operating in 
370-XA mode, the channel subsystem attempts to use the preferred path to initiate 
I/O requests. The channel subsystem tries to initiate every I/O request for the 
desired device using the preferred channel path first (before it attempts to initiate the 
request on other attaching channel paths, if any exist). 

If the channel subsystem cannot initiate the I/O request on the preferred path either 
because of a busy condition or because the channel path, control unit, or device is 
already known to be busy, the channel subsystem tries to initiate the request on the 
other attaching channel paths. 

If no preferred channel path is specified, the channel subsystem uses the rotation 
algorithm to initiate I/O requests associated with the device's logical control unit. 
The channel subsystem attempts to initiate each new I/O request using a channel 
path rotation algorithm. For example, if you attach a device to four channel paths, 
the channel subsystem tries to initiate the first I/O request on the first channel path, 
the second request on the second channel path, the fifth request on the first channel 
path, and so forth. 

The preferred channel path parameter is useful in controlling the path selection logic 
of the channel subsystem to minimize contention for a device. For example, 
consider the following configuration: 

• Two strings of DASDs (0-7 and 8-F), each attached to two 3830 control units (A 
and B). 

• Control unit A attaches to channel path 01 and control unit B attaches to 
channel path 02. 

In this configuration, the channel subsystem is capable of initiating I/O requests to 
any of the devices from either of the two attaching channel paths. You can use the 
preferred path to minimize string busy conditions that the channel subsystem might 
encounter as it tries to initiate requests for the devices. By defining each string of 
devices with a different preferred channel path (for devices 0-7, specify PATH = 01; 
for devices 8-F, specify PATH = 02), you minimize the device busy conditions. 
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Rotation Algorithm 

Each logical control unit has one to four channel paths. lOCP establishes a channel 
path rotation order for the initiation of I/O requests when the processor is operating 
in 370-XA mode. You can affect the rotation by changing the order of the channel 
path identifiers on the CNTLUNIT macro instructions. 

To estabhsh the rotation order, lOCP checks the control units within the logical 
control unit in ascending order of control unit numbers (specified on the 
CNTLUNIT macro instructions). lOCP takes the first user-entered channel path 
(on the CNTLUNIT macro instruction) from each control unit. lOCP then 
repeatedly checks the control units in ascending order. Each time, lOCP takes the 
next user-entered channel path, if there is one, until it orders all the channel paths in 
the logical control unit. 

Logical control unit 2 in Figure 1-3 shows an example of how specifying the paths 
in a logical control unit can affect the path rotation order. If you specify 
PATH = (01,07) on the CNTLUNIT macro instruction for physical control unit 2, 
and PATH = (02,04) for physical control unit 3, the rotation order is 01, 02, 07, 04. 
However, if you specify PATH = (07,01) on the CNTLUNIT macro instruction for 
control unit 2, and PATH = (02,04) for control unit 3, the rotation order is 07, 02, 
01, 04. 

The channel subsystem attempts to initiate each new I/O request on a rotating 
channel path basis. If a device has a preferred path, the channel subsystem always 
tries the preferred path first, the channel path following the preferred path in the 
rotation order next, and so forth. 

If a device does not have a preferred path, the channel subsystem first tries the next 
channel path in the rotation order following the last channel path used for an I/O 
request to a device in that logical control unit. If the first channel path tried is busy, 
the channel subsystem continues in the established rotation order. 

Note: The same channel path connected to more than one control unit in the same 
logical control unit, appears only once in the rotation order. lOCP removes 
duplicate channel path identifiers from the logical control unit provided that the 
total number was 4 or less. 

Channel Path Selection on a 3084 Processor Complex 

On a 3084 Processor Complex with both sides configured, each side has its own 
rotation algorithm for channel path selection. Figure 1-5 shows an example of a 
device attached to two control units, with each control unit attached to a channel 
path on both the A side and the B side. If you specify PATH = (02,42) on the 
CNTLUNIT macro instruction for control unit 13, and PATH = (12,52) for control 
unit 14, the rotation order in the lOCDS for the logical control unit is 02, 12, 42, 52. 
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Figure 1-5. Channel Path Selection on a 3084 Processor Complex 

If the device does not have a preferred path, or if the preferred path is busy, the 
channel subsystem tries the next channel path in the rotation order (for the logical 
control unit) that is on the side on which it attempts to initiate the I/O request. If 
the last channel path used is 02 on the A side and 42 on the B side, then 12 is the 
next channel path tried on the A side and 52 is the next channel path tried on the B 
side. It is unpredictable whether the channel subsystem will try channel path 12 or 
52 next. It is even possible that the channel subsystem will try channel path 52, and 
then 42 next (before channel path 12) because the two sides are independent in their 
selection of channel paths. 



Device Address 



In 370 mode, a device address consists of three hexadecimal digits that uniquely 
identify an I/O device. (The device address is assigned in the ADDRESS parameter 
on the lODEVIGE macro instruction and is a term used in 370 mode. The term 
device number is used in 370-XA mode.) The first digit of the device address must 
specify the channel number that corresponds to the lowest-numbered channel path 
assigned to the device (370-XA mode does not have this requirement). This channel 
path is the primary channel address for the device. The second and third digits 
specify the physical unit address of the device. 
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Device Number 



In 370-XA mode, a device number uniquely identifies an I/O device. (The device 
number is assigned in the ADDRESS parameter on the lODEVICE macro 
instruction.) The device number consists of three hexadecimal digits that can be the 
same as the device address used in 370 mode. If you want to use the lOCDS only in 
370-XA mode, you can choose the first digit of the device number arbitrarily, with 
the exception that MVS requires that the first digit must be the same for each device 
on a single control unit or for each DASD on a single string. The second and third 
digits are the physical unit address. If you want to use the same lOCDS for both 
370 mode and 370-XA mode operation, you must specify the device numbers for 
370-XA mode the same way you specify device addresses for 370 mode. 

When defining an I/O configuration for 370-XA mode with a large number of I/O 
devices, there may be situations when it is difficult or undesirable to assign device 
numbers that contain the physical unit address of the device. You may find it is 
necessary to assign the same unit address to more than 16 devices each on a separate 
channel path. However, this is not possible using only the ADDRESS parameter 
because you are limited to one hexadecimal digit and device numbers must be 
unique.) For example, you wish to assign the unit address 'FO' to 20 devices. The 

devices would have the device numbers as follows: IFO, 2F0, 3F0 FFO (the 

sixteenth device). The remainder of the devices would have duplicate device numbers 
which is not permitted (device numbers must be unique). 

When this occurs, you may want to use the UNITADD parameter on the 
lODEVICE macro instruction. 

UNITADD is an optional parameter that allows you to assign a device number in 
the ADDRESS parameter on the lODEVICE macro instruction that does not have 
the actual physical unit address of the I/O device as the two rightmost digits of the 
device number. (The device number is the three hexadecimal digits specified in the 
ADDRESS parameter.) The channel subsystem uses the two hexadecimal digits that 
you specify on the UNITADD parameter to address the device rather than the unit 
address specified in the ADDRESS parameter. When you use the UNITADD 
parameter on the lODEVICE macro instruction the unit address (the two rightmost 
digits in the ADDRESS parameter) is not required to be the physical unit address. 
Because the channel subsystem uses the two digits specified in the UNITADD 
parameter to address the device, these two hexadecimal digits must be the the 
physical unit address of the I/O device. 

Specify the UNITADD parameter on the lODEVICE macro instruction only for an 
lOCDS used exclusively for 370-XA mode operation. If you use the UNITADD 
parameter to create an lOCDS for both 370 mode and 370-XA mode operation, the 
device number for 370-XA mode will not be the same as the device address for 370 
mode. They are not the same because the two hexadecimal digits you specify on the 
UNITADD parameter become the second and third digits of the device address. 
(The second and third digits of the device address must be the physical unit address 
of the device.) 

Use the UNITADD parameter carefully. See Appendix D for the exceptions and 
recommendations that apply to specific device types. 
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Notes: 

1. The device number is always the three hexadecimal digits that you specify in the 
ADDRESS parameter of the lODEVICE macro instruction in 370-XA mode. 
(The UNIT ADD parameter does not change the device number.) 

2. If you specify the UNIT ADD parameter on the lODEVICE macro instruction, 
these two digits become the physical unit address that the channel uses to 
address the selected control unit in both 370 mode and 370-XA mode. 

3. If you use the UNIT ADD parameter on the lODEVICE macro instruction when 
you are operating in 370 mode the two digits specified in the UNITADD 
parameter replace the two rightmost digits specified in the ADDRESS parameter 
as the physical unit address. The UNITADD parameter on the lODEVICE 
macro instruction changes the device address. This changing of the device 
address (370 mode) could result in operational and serviceability problems. 

Control Unit Types 

When defining a 370 mode I/O configuration, you use the SHARED parameter on 
the CNTLUNIT macro instruction to indicate whether the control unit allows 
shared or nonshared subchannels. With 370-XA architecture, shared subchannels do 
not exist. Every device has its own subchannel. 

For 370-XA mode, lOCP defines control units as type 1 or type 2. Type 1 control 
units allow only a single channel program at any one time. Type 2 control units 
allow multiple channel programs concurrently. lOCP uses the SHARED parameter 
to determine the control unit type as follows: 

• If the user specifies SHARED = Y or SHARED = YB, lOCP defines the control 
unit as type 1 . The channel subsystem supports only one I/O request at a time 
(serializes). 

• If the user specifies SHARED = N, IOC? assigns the control unit as type 2. The 
channel subsystem supports multiple requests. 

You specify the SHARED parameter in the same way for both 370 mode and 
370-XA mode. 

Note: The processor complexes listed on the cover of this manual define control 
units as only type 1 and type 2. The processor complexes treat a type 3 control unit 
as a type I. To define a type 3 control unit, specify SHARED = YB for 370 mode 
and SHARED = Y or SHARED = YB for 370-XA mode. IBM Systeml360 and 
System/370 I/O Interface Channel to Control Unit Original Equipment Manufacturer's 
Information, GA22-6974 define control unit types. 
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Versions of lOCP 

There are three versions of lOCP: the MVS version, the VM version, and the 
stand-alone version. 

Overview of the MVS Version of lOCP 

The MVS version of lOCP runs as a job under control of MVS (MVS/370 or 

MVS/XA). 

You invoke the MVS version of lOCP via MVS JCL statements. By coding options 
on the FARM parameter of the EXEC statement, you can request the following 
lOCP functions: 

• Generating an lOCDS -- lOCP reads, validates, and checks the syntax of the 
input macro instructions. It generates an lOCDS in storage based on the 
configuration defined on the macro instructions and produces reports of the 
lOCDS generated in storage. When requested, lOCP writes the generated 
lOCDS to one or more lOCDS(s) in the processor controller. 

• Producing Configuration Reports ~ lOCP reads one or more lOCDS(s) from the 
processor controller into storage and prints the lOCP configuration reports. 
(See "Chapter 5. lOCP Configuration Reports" for examples.) 

The MVS version of lOCP has an advantage over the stand-alone version; you may 
modify an lOCDS while other system operations continue. Then, at a convenient 
time, shut down MVS, power-on reset the processor complex with the new lOCDS, 
and re-load MVS. This method minimizes the amount of time that the system must 
be inactive while you reconfigure the I/O devices. 

See "Chapter 2. Executing the MVS Version of lOCP" for a full descripfion of the 
MVS version of lOCP. 

iOCP and MVS System Generation 

For an MVS (MVS/370 or a release of MVS/XA prior to MVS/SP 2.2.0) system 
generation, we recommend that you combine the IOCP and MVS system generation 
macro instructions to form one combined input deck for use by both IOCP and 
MVS system generation. One combined input deck ensures that the definitions of 
your software and hardware I/O configurations are identical for a processor 
complex. 

Installations using MVS/SP 2.2.0 or subsequent releases will use the MVS 
Configuration Program to perform the system generation function. 

IOCP processes the IOCP macro instructions (ID, CHPID, and CNTLUNIT) and 
the lOCP-related parameters on the lODEVICE macro instructions to define the 
hardware I/O configuration. The macro instructions that MVS system generation 
processes to define the software depends on whether it is an MVS/370 system 
generation or an MVS/XA (releases prior to MVS/SP 2.2.0) system generation. 
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Summary of MVS/370 System Generation 

The following is a summary of the MVS/370 system generation macro instructions 
and the processing for a combined deck: 

• The lOCP CHPID macro instruction replaces the system generation CHANNEL 
macro instruction. For an MVS/370 system generation, the CHANNEL and 
CHPID macro instructions are mutually exclusive. That is, you cannot specify 
them in the same input deck. MVS/370 system generation obtains the channel 
number and channel type from the CHPID macro instruction for its own 
processing. 

• MVS/370 system generation ignores the lOCP-related parameters CUNUMBR 
and TIMEOUT on the lODEVICE macro instruction. However, if the PATH 
parameter or UNIT ADD parameter is on any of the lODEVICE macro 
instructions, you cannot use a combined deck for an MVS/370 system 
generation. All other parameters remain unchanged for system generation 
processing. 

• MVS/370 system generation ignores the lOCP ID and CNTLUNIT macro 
instructions. 

• All other MVS/370 system generation macro instructions and parameters remain 
unchanged. 

Summary of MVS/XA System Generation 

The following is a summary of the MVS/XA (releases prior to MVS/SP 2.2.0) system 
generation macro instructions and the processing for a combined deck: (MVS SP 
2.2.0 provides the MVS Configuration Program (MVSCP) to perform the system 
generation functions.) 

• MVS/XA system generation ignores the lOCP-related parameters CUNUMBR, 
PATH, TIMEOUT and UNIT ADD on the lODEVICE macro instruction. All 
other parameters remain unchanged for MVS system generation processing. 

• MVS/XA system generation ignores the lOCP CHPID, CNTLUNIT, and ID 
macro instructions. 

• All other MVS/XA system generation macro instructions and parameters remain 
unchanged. 

In the combined input deck, you can also define channels and devices for use only 
by processor complexes other than the processor complexes hsted on the cover of 
this manual. These channel and device definitions are for MVS system generation 
only, and you instruct lOCP to exclude them from the lOCDS. For information on 
coding these channels and devices, see the descriptions of the PATH parameter on 
the CHPID macro instruction and the CUNUMBR parameter on the lODEVICE 
macro instruction in Chapter 2. 

Appendix B shows a Usting of a typical combined input deck containing both lOCP 
and MVS system generation macro instructions. This deck is input both for an 
MVS/370 system generation and a 370/370-XA level of lOCP. MVS/XA may not 
support some of the devices defined in this deck. (See MVSj Extended Architecture 
System Generation Reference.) 

MVS system generation processes the lOCP macro instructions, in the same manner 
as the system generation macro instructions, lOCP itself does not use a macro 
generation process. lOCP processes its macro instructions in the same way as it 
processes control statements. 
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For a full description of the lOCP macro instructions and the lOCP-related 
parameters on the lODEVICE macro instruction, see "Specifying lOCP Macro 
Instructions" in Chapter 2. For a full description of MVS system generation macro 
instructions, see 0S/VS2 System Programming Library: System Generation Reference 
or MVSj Extended Architecture System Generation Reference. 

Figure 1-6 shows an overview of the processing performed by the MVS version of 
lOCP. 
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The input deck contains both MVS system generation and lOCP macro 
instructions (or lOCP macro instructions only). 

lOCP processes the lOCP macro instructions, generates an lOCDS in storage, 
produces reports, and, when requested, writes the generated lOCDS to 
one or more lOCDS(s) in the processor controller. 

3. The configuration reports allow you to check the I/O configuration as 
defined in the lOCDS. 

4. The lOCDS(s) reside on the processor controller file. At power-on reset 
or SYSIML CLEAR, the processor controller microcode loads the I/O 
configuration data into hardware system area (HSA). (The channel subsystem 
subsequently uses the data to control I/O requests.) 
MVS system generation processes the system generation macro instructions 
and creates the MVS system. 



5. 



Figure 1-6. MVS Version (releases prior to MVS/SP 2.2.0) of lOCP - Overview 
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lOCP and MVS Configuration Program (MVSCP) 

The MVS configuration program replaces the I/O definition functions (lOGEN and 
EDTGEN) previously available through SYSGEN. The MVS configuration 
program, in combination with other program enhancements, enables one copy of the 
MVS nucleus to support multiple I/O configurations. Also, with the MVS 
configuration program, modifications to the nucleus do not have to be reapphed 
after an installation updates an existing I/O configuration. 

In addition to defining each I/O configuration to MVS, you must also use the lOCP 
configuration program (lOCP) to define the configuration to the channel subsystem. 
You can use the same input stream to define the configuration to both the MVS 
configuration program and lOCP. 

Figure 1-7 on page 1-22 shows the relationship of lOCP and MVS Configuration 
Program. 

Although the figure shows the MVS configuration program and the lOCP running at 
the same time, you can actually run these programs at separate times independent of 
each other. They are shown together only to remind you that they share a common 
input stream. 
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Figure 1-7. lOCP and MVS Configuration Program 
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Overview of the VM Version of lOCP 

The VM version of lOCP runs under the control of either the VM/System Product 
(VM/SP), the VM/System Product High Performance Option (VM/SP HPO), or the 
VM/Extended Architecture Systems Facility (VM/XA Systems Facility). 

You invoke the VM version of lOCP in the CMS environment. The CMS lOCP 
command executes lOCP and has options that allow you to request the following 
lOCP functions: 

• Generating an lOCDS -- lOCP reads, validates, and checks the syntax of the 
input macro instructions. It generates an lOCDS in storage based on the 
configuration defined by the macro instructions and produces reports of the 
lOCDS generated in storage. When requested, lOCP writes the generated 
lOCDS to one or more lOCDS in the processor controller. 

• Producing Configuration Reports ~ lOCP reads one or more lOCDS(s) from the 
processor controller into storage and prints the lOCP configuration reports. 
(See "Chapter 5. lOCP Configuration Reports" for examples.) 

The VM version of lOCP has an advantage over the stand-alone version: you may 
modify an lOCDS while other system operations continue. Then, at a convenient 
time, shut down your VM/SP, VM/SP HPO, or VM/XA Systems Facihty system, 
power-on reset the processor complex (with the new lOCDS), and re-load VM/SP, 
VM/SP HPO, or the VM/XA Systems Facility. This method minimizes the amount 
of time that the system must be inactive while you reconfigure the I/O devices. 

For a full description of the VM version of lOCP, see "Chapter 3. Executing the 
VM Version of lOCP." 

lOCP and System Generation of a Vl\/I Operating System 

You must define your I/O configuration to both software and hardware. 

To define your I/O configuration to software, you use a set of I/O macro 
instructions in the real I/O configuration file for your VM operating system: 

• For VM/SP or VM/SP HPO, the real I/O configuration file is the DMKRIO 
file. 

• For the VM/XA Systems Facility, the real I/O configuration file is the HCPRIO 
file. 

When you perform system generation, the Control Program (CP) uses the macro 
instructions in the real I/O configuration file to define the I/O configuration to the 
operating system. 

To define your I/O configuration to hardware, you use another set of I/O macro 
instructions in a separate lOCP file. When you enter the lOCP command, the lOCP 
program uses the I/O macro instructions in the lOCP file to define the I/O 
configuration to the processor complex. 

For more information about performing these tasks, see "Methods of Executing the 
VM Version of lOCP" in Chapter 3. 

Figure 1-8 shows an overview of the processing performed by the VM version of 
lOCP. 
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1. For VM/SP and VM/SP HPO system generation, the DMKRIO file defines the 

I/O configuration information; for VM/XA Systems Facility system generation, 
the HCPRIO file defines the I/O configuration. 

2. The input file contains the lOCP macro instructions used to define the 
I/O configuration to the processor controller. 

3. lOCP processes the lOCP macro instructions, generates an lOCDS in 
storage, produces reports, and, when requested, writes the generated 
lOCDS to one or more lOCDS(s) in the processor controller. " 

4. The configuration reports allow you to check the I/O configuration as 
defined in the lOCDS. 

5. The IOCDS(s/ reside in the processor contrbller file. At pdwer-on reset 
or SYSIML CLEAR, the processor controller microcode loads the I/O 
configuration data into the hardwaire system area (HSA). (The channel 
subsystem subsequently uses the data to control I/O requests.) 



Figure 1-8. VM Version of lOCP - Overview 
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Overview of the Stand-Alone Version of lOCP 

The stand-alone version of lOCP is a stand-alone program operated from the system 
console or the service support console on the processor complex. 

You execute the stand-alone version of lOCP to define I/O configuration data when 
you are operating your system before installing MVS, VM/SP, VM/SP HPO, or the 
VM/XA Systems FaciHty, or when you are operating your system with a control 
program other than these. 

You start lOCP from the system console or the service support console. Briefly, the 
functions you can request are: 

• Read an lOCDS from the processor controller into the lOCDS area of main 
storage. 

• Display, add, alter, and delete I/O configuration data from the lOCDS in 
storage. 

• Print reports of the lOCDS that is in storage. 

• Build an lOCDS in storage (which also produces reports) based on the 
card-image macro instructions read from a card reader or magnetic tape. 

• Write the lOCDS (generated or modified) in storage to an lOCDS in the 
processor controller. 

Also, when you are executing the stand-alone version of lOCP, you can dump the 
lOCP storage area, which includes the lOCDS in storage. 

For a full description of the stand-alone version of lOCP, see "Chapter 4. Executing 
the Stand-Alone Version of lOCP". 

Figure 1-9 shows an overview of the processing performed by the stand-alone 
version of lOCP. 
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1. The system console or service support console starts and controls lOCP. 

2. The input deck contains lOCP macro instructions only (or lOCP macro 
instructions combined with MVS system generation macro instructions). 

3. lOCP processes lOCP screen commands from the console to control lOCP 
functions and processes input from the input deck or from the console 
screen. lOCP builds an lOCDS in storage. 

4. Configuration reports allow you to check the I/O configuration data as 
defined in the lOCDS. 

5. The lOCDS resides in the processor controller file. At power-on reset 
or SYSIML CLEAR, the processor controller microcode loads the I/O 
configuration data into the hardware system area (HSA). (The channel 
subsystem subsequently uses the data to control I/O requests.) 



Figure 1-9. Stand- Alone Version of lOCP - Overview 
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Chapter 2. Executing the MVS Version of lOCP 



The MVS version of the input/output configuration program (lOCP) runs as a job 
under control of MVS (MVS/370 or MVS/XA) The lOCP program name is 
ICPIOCP. 

You use JCL statements to execute lOCP. On the EXEC statement, you code 
options on the PARM parameter to request one of the following two lOCP 
functions: 

• Generating an Input/Output Configuration Data Set (lOCDS) - lOCP reads, 
validates, and checks the syntax of input macro instructions. It generates an 
lOCDS in storage based on the configuration defined on the macro instructions 
and produces reports of the lOCDS generated in storage. When requested, lOCP 
writes the generated lOCDS to one or more lOCDS(s) in the processor 
controller. 

• Producing Configuration Reports - lOCP reads one or more lOCDS(s) from the 
processor controller into storage and prints the lOCP configuration reports. 
(See "Chapter 5. lOCP Configuration Reports" for examples.) 

The following topics describe: 

• How to specify lOCP macro instructions * 

• The two functions lOCP performs 

• The JCL statements required to execute these functions (with examples) 

• The return codes lOCP can set 

• How to initially define the I/O configuration or to redefine an existing I/O 
configuration. 



© Copyright IBM Corp. 1980, 1989 
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Specifying lOCP IVIacro Instructions 



This section describes the purpose of the lOCP macro instructions and explains how 
to code them. The first topic in this chapter summarizes the I/O configuration rules 
that apply to the lOCP macro instructions. Subsequent topics describe the lOCP 
macro instructions in alphabetic order. 

The rules for coding the IOC? card-image macro instructions are the same as the 
rules for coding MVS system generation or MVSCP macro instructions. They are 
the rules of assembler language. See "Appendix A. Coding lOCP Macro 
Instructions" for a summary of the rules for coding the macro instructions and the 
notation used in this book to illustrate the macro instructions. 

lOCP has four macro instructions: CHPID, CNTLUNIT, lODEVICE, and ID. 
lOCP requires the CHPID, CNTLUNIT, and lODEVICE macro instructions. The 
CHPID, CNTLUNIT, and lODEVICE macro instructions define respectively, the 
channel paths, control units, and I/O devices in your configuration. The ID macro 
instruction is optional. If you want specific identification information in the heading 
of the lOCP configuration reports, code the ID macro instruction. 

The following general rules apply to the sequence of the lOCP macro instructions in 
the input deck. 

• You can code the ID macro instruction only once and it must precede other 
lOCP macro instructions. 

• A CHPID macro instruction that defines the channel path must precede a 
CNTLUNIT macro instruction that refers to the channel path. 

• A CNTLUNIT macro instruction must follow the CHPID macro instruction 
that defines the channel path to which the control unit attaches. 

• An lODEVICE macro instruction must •oUow the CNTLUNIT macro 
instruction that defines the control unit to which the device is assigned. 

• You can insert lOCP comment cards (specified by the characters *IOCP in 
columns 1 through 5) in the input deck where desired. 

We suggest that you group all CHPID macro instructions together, followed by all 
CNTLUNIT macro instructions, and then all lODEVICE macro instructions. Or, 
you might group all CHPID macro instructions together, followed by groups of 
related CNTLUNIT and lODEVICE macro instructions (as shown in Appendix B). 

Figure 2-1 shows a typical combined input deck containing lOCP macro instructions 
and, MVS system generation macro instructions. Appendix B shows a hsting of a 
typical combined input deck containing both lOCP and system generation macro 
instructions. 
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1. ID macro instruction (optional) defines heading data for 
configuration reports; lOCP allows only one ID macro instruction. 

2. CHPID macro instruction (required) defines channel paths. You can 
define up to 8 channel paths on each CHPID macro instruction. 

3. CNTLUNIT macro instruction (required) defines control units. You must 
define each control unit on a separate CNTLUNIT macro instruction. 

4. lODEVICE macro instruction (required) defines I/O devices. You can 
define up to 256 I/O devices on an lODEVICE macro instruction. 

The lODEVICE macro instruction contains information required by both 
MVS system generation and lOCP. 

5. MVS system generation macro instructions (required and optional MVS 
system generation macro instructions - excluding CHANNEL macro 
instructions) define the software configuration. (The CHPID macro 
instructions replace the CHANNEL macro instructions in an MVS/370 
system generation. An MVS/XA system generation does not use the 
CHANNEL macro instruction.) 



Figure 2-1. Typical Combined Input Deck (lOCP and MVS System Generation) 
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Summary of I/O Configuration Rules 



Here is a summary of the rules and restrictions for lOCP macro instructions 
described in the following topics. 



For channel paths 



For control units 



You can specify all channel paths as block multiplexer 

• You can specify, for the A side, only channel paths 00, 01, 02, 03, 10, 11, 12, 
and 13 (hex) as byte multiplexer. 

• You can specify, for the B side, only channel paths 40, 41, 42, 43, 50, 51, 52, 
and 53 (hex) as byte multiplexer. 

• You can specify a maximum of four channel paths on each side as byte 
multiplexer. 



• You can attach a physical control unit to a maximum of four channel paths per 

system. 

• You can assign a maximum of 16 control units to one channel path. 

• Only a non-shared control unit (specified by SHARED = N on the CNTLUNIT 
macro instruction) can attach to a channel path that operates in byte multiplexer 
mode. 

• Only a control unit attached to a block multiplexer channel path can use the 
data streaming interface protocol. That is, if PROTOCL = S or S4 on the 
CNTLUNIT macro instruction, the channel path(s) to which the control unit 
attaches must have TYPE = BL specified on the CHPID macro instruction(s). 

• When you are running lOCP to verify the card-image input deck, 
(WRTCDS = NO), lOCP allows a maximum of two channel paths per data 
server element (DSE) to attach to physical control units that have 
PROTOCL = S4. Likewise, when generating an lOCDS on a Model X 
processor, lOCP allows a maximum of two channel paths per DSE to attach to 
physical control units that have PROTOCL = S4. However, when generating an 
lOCDS on a processor that is not a Model X, lOCP restricts the channel paths 
that can attach to the physical control unit that has PROTOCL = S4. This 
control unit can attach only to channel paths with the following identifiers: 06, 
07, 16, 17, 26, 27, 46, 47, 56, 57, 66, and 67. For a pictorial description of data 
server elements, see Figures 1-1 and 1-2 in Chapter 1. 
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For I/O devices 



For 370-XA mode 



The maximum number of I/O devices is 4080. 

The sum of the number of I/O devices plus the number of logical control units 
cannot exceed 4096. 

You can assign a maximum of 256 I/O devices to one channel path. 

You can assign a device to a maximum of four control units. 

When you assign a device to more than one control unit, each control unit must: 
(1) recognize the same unit address for the device, (2) not attach to the same 
channel path, (3) have the same PROTOCL value, and (4) have the same 
characteristics, such as shared, shared block, or nonshared. 

You can assign a device only to a combined maximum of four channel paths 
(even though you can assign a device to up to four control units and attach a 
control unit to up to four channel paths). 

You cannot assign a device that has the I/O interface timeout function inhibited 
to a channel path that operates in byte multiplexer mode. 

Each I/O device must have a unique device address/number within the I/O 
configuration. lOCP does not allow duphcate device addresses/numbers. 



If you have a deck of lOCP macro instructions coded for the 370 level of lOCP, 
in most cases you can use the same deck as input to create a 370/370-XA 
lOCDS. MVS/XA may not support all of the defined devices. 

Note: I/O configurations that are valid for the 370 level of lOCP or for 370 
only machines may be invalid for the 370-XA level of lOCP. It is important to 
fully understand the concepts and requirements of logical control units. It may 
be necessary to physically reconfigure a system if the requirements for logical 
control units have not been met. You must review the current configuration to 
insure that the configuration is valid for the 370-XA level of lOCP. This is 
necessary whether you are running your processor in 370 mode or in 370-XA 
mode. 

You can define a channel path and its attached I/O devices exclusively for 
370-XA mode by removing the channel number and channel set for that channel 
path from the CHPID macro instruction. 

The PATH parameter on the lODEVICE macro instruction specifies a preferred 
path. The preferred path is an optional parameter used only for 370-XA mode 
operation. 
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CHPID 



CHPID, a required macro instruction, describes: 

• The characteristics of channel paths 

• The correspondence of channel paths to channel numbers and channel sets 

You must specify each channel path in your I/O configuration on a CHPID macro 
instruction in order to use the channel path. You can specify up to eight channel 
paths on one CHPID macro instruction. When using an input deck containing MVS 
system generation and lOCP macro instructions, you can define, to MVS system 
generation, channels used only by processors other than the processor complexes 
listed on the cover of this manual. (See the note in the description of chpid number 
on the PATH parameter.) 

Note: For an MVS/370 system generation, the CHPID macro instruction is 
mutually exclusive with the system generation CHANNEL macro instruction. You 
cannot specify the CHPID and CHANNEL macro instructions in the same input 
deck to the MVS system generation process. On the CHPID macro instruction, the 
channel number on the PATH parameter replaces the ADDRESS parameter of the 
CHANNEL macro instruction, and the TYPE = BL and TYPE = BY parameters 
replace the TYPE = BLKMPXR and TYPE = MULTIPLEXOR parameters 
respectively. The CHPID macro instruction does not support the 
TYPE = SELECTOR and TYPE = HISPEEDMPXR parameters on the CHANNEL 
macro instruction. 

The CHPID macro instruction must follow the ID macro instruction, if you specified 
the ID macro instruction). The CHPID macro instruction must precede any 
CNTLUNIT macro instructions that refer to the channel path. 

The format of the CHPID macro instruction is: 



[symbol] 


CHPID 


PATH = ((chpid number[,channel number 
[,channel set]]),...) 
TYPE = {BL|BY} 



PATH = 

specifies one or more channel path identifiers. If the devices on a channel path 
are for use in 370 mode, you must specify the channel path's corresponding 
channel number. Optionally, you may specify the channel path's associated 
channel set. You can specify a maximum of eight channel paths on one CHPID 
macro instruction. If you specify more than one channel path on a macro 
instruction, all channel paths must have the same TYPE characteristic. You 
cannot specify a channel set without specifying a channel number. 

chpid number 

specifies the channel path identifier. For the A side, you must specify two 
hexadecimal digits in the range of 00 through 07, 10 through 17, or 20 
through 27. (Channel paths 10 thro ugh 17 and 20 through 27 are optional 
by model.) For the B side, you must specify two hexadecimal digits in the 
range of 40 through 47, 50 through 57, or 60 through 67. 
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Note: Specify ** (two asterisks) instead of a chpid number when defining, 
to MVS system generation a channel used only by processors other than the 
processor complexes Usted on the cover of this manual. You can code ** 
only if you use card-image input and specify IGNORE = YES. lOCP 
ignores the channel number and channel set following **; it does not include 
them in the lOCDS. 

For example, the 3081 Processor Complex can have up to 24 channel paths 
while the 3033 Processor Complex can have up to 32 channel paths. In a 
combined input deck used by both lOCP and MVS system generation, you 
specify ** to have lOCP ignore (not include in the lOCDS) the additional 
channels of the 3033 Processor Complex. 

For devices you assign to channels used only by processors other than the 
processor complexes Usted on the cover of this manual, you must code the 
lODEVICE macro instruction so that lOCP does not include the devices in 
the lOCDS. See the description of the CUNUMBR parameter on the 
lODEVICE macro instruction. 

channel number 

specifies the channel number that corresponds to the channel path when the 
processor complex operates in 370 mode. You specify one hexadecimal digit 
in the range of through F. Channel numbers must be unique and 
consecutive within a channel set. 

To specify a channel set, you must specify a channel number. If you do not 
specify the channel number, you cannot access the devices attached to the 
channel path when the processor complex operates in 370 mode. 

channel set 

specifies the channel set used for 370 mode. You specify a value of or 1 
for the channel set. If you do not specify a channel set, lOCP assigns the 
channel path to channel set 0. 

On a processor complex with both an A side and a B side, each side has two 
channel sets (0 and 1) in 370 mode. 

On the uniprocessors, MVS/370 can access only channel paths assigned to 
channel set 0. Therefore, you must either specify a value of or accept the 
default of 0. (You can assign channel paths to channel set 1; however, 
MVS/370 cannot access these channel paths on a uniprocessor.) 

A channel set cannot have more than 16 channel paths assigned to it. The 
two channel sets (0 and 1) can have a maximum combined total of 24 
channel paths on each side. (For example, 16 channel paths assigned to 
channel set and 8 channel paths assigned to channel set I, or 12 channel 
paths assigned to channel set and 12 channel paths assigned to channel set 
I.) 

For the processor complex, you must assign consecutive channel numbers 
within a channel set. (For example, channel numbers 0, 1,2, 3, 4, 5, or 
channel numbers 8, 9, A, B, C, D.) The channel path identifiers do not need 
to be consecutive. . 

For a uniprocessor, processor 2 (the only processor) always connects to 
channel set at power-on reset, SYSIML or SYSIML CLEAR. For a 
processor complex with more than one processor, channel set connection at 
power-on reset, SYSIML or SYSIML CLEAR depends on whether the 
processor complex has one or both processors configured. 
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When the processor complex has both processors config ured, channel set 
connects to processor 0, and channel set 1 connects to processor 2 at 
power-on reset, SYSIML or SYSIML CLEAR. (If the processor complex 
has a B side, channel set on the B side connects to processor 1 , and 
channel set 1 on the B side connects to processor 3.) When the processor 
complex subsequently resets (such as a system reset or load), channel set 
reconnects to processor (or processor 1 on the B side) and channel set 1 
reconnects to processor 2 (or processor 3 on the B side). 

If you remove either processor from the processor complex (the processor 
fails or you take it offline), channel set and channel set 1 both remain 
configured. However when you remove a processor, a subsequent reset 
causes the connection of channel set to the remaining processor on that 
side. The reset does not connect channel set 1, but you can connect channel 
set 1 after IPL by activating channel set switching. Therefore, we 
recommend that you assign critical asymmetrically attached devices (such as 
the operator's console) to a channel path assigned to channel set 0. 

TYPE = 

specifies the mode of I/O operation for the channel path. If you specify more 
than one channel path on a macro instruction, all channel paths must have the 
same TYPE characteristic. 

BL 

specifies that the channel path is a block multiplexer channel, which operates 
in burst mode only and allows multiplexing between blocks. You can 
specify TYPE = BL for all channel paths with the exception that MVS 
system generation requires that the channel path assigned as 370 channel 
number be a byte multiplexer channel. 

BY 

specifies that the channel path is a byte multiplexer channel, which operates 
in burst mode or byte-interleave mode, depending on the attached control 
unit. You can specify TYPE = BY for only channel paths 00 through 03 and 
10 through 13 (hex) on the A side, and for channel paths 40 through 43 and 
50 through 53 (hex) on the B side. You can specify a maximum of four 
channel paths on each side as TYPE = BY. 

Note: All channel paths defined with the same channel number must specify the 
same type value. 

Example: The following macro instruction (named CHSETl) defines two channel 
paths (hex 15 and 16) with their corresponding channel numbers (hex 8 and 9) in 
channel set 1. It also defines a channel (using ** instead of a chpid number) with 
channel number hex A in channel set 1. By using **, you define the channel to 
MVS system generation for use by processors other than the processor complexes 
listed on the cover of this manual. lOCP excludes from the lOCDS the channel 
number and channel set following **. The channel paths are to operate in block 
multiplexer mode. 



CHSETl 


CHPID 


PATH = ((15,8,1),(16,9,1),(**,A,1)),TYPE = BL 
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Example: The following macro instruction (named CHP17) defines channel path 17. 
The channel path operates in block multiplexer mode. Because no channel number 
is specified, the processor complex can access the devices attached to this channel 
path only when it operates in 370-XA mode. 



CHP17 


CHPID 


PATH = 17,TYPE = BL 
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CNTLUNIT 



CNTLUNIT, a required macro instruction, describes: 

• The characteristics of the control unit 

• The channel paths to which the control unit attaches 

• The unit addresses that the control unit recognizes 

You must specify each physical control unit in your I/O configuration in a separate 
CNTLUNIT macro instruction to use the physical control unit. This requirement 
includes control units that reside either in the same physical unit as an I/O device or 
another control unit. 

You can attach a control unit to a maximum of four channel paths. You can assign 
a maximum of 1 6 control units to one channel path. 

See Appendix D for a list of control unit types and their characteristics. 

Based on information in the CNTLUNIT macro instruction(s), lOCP constructs 
logical control units for the channel subsystem to use when the processor runs in 
370-XA mode. A logical control unit is a logical representation of one to four 
physical control units. lOCP builds a logical control unit for: 

• Each control unit with no devices or no devices shared with other control units. 

• Each group of two to four control units that share devices between them. 

The channel subsystem uses the logical control units for queuing I/O requests for the 
devices attached to the associated physical control units. There is one I/O request 
queue for each logical control unit. The channel subsystem queues all I/O requests 
for all devices in the logical control unit (all the devices attached to the set of 
physical control units in the logical control unit) to the same I/O request queue. 

lOCP also establishes a rotation order for the channel paths associated with each 
logical control unit. When initiating I/O requests queued to the logical control unit, 
the channel subsystem uses this rotation order to determine the sequence for 
selecting channel paths. The section "Rotation Algorithm" in Chapter 1 describes 
how lOCP establishes the rotation order of the channel paths. 

The CNTLUNIT macro instruction must follow any CHPID macro instructions that 
specify channel paths used by the control unit. The CNTLUNIT macro instruction 
must precede any lODEVICE macro instructions that refer to the control unit. 

The format of the CNTLUNIT macro instruction is: 



[symbol] 


CNTLUNIT 


CUNUMBR = number 

PATH = (chpid[,chpid]...) 

[PROTOCL = {D|S|S4}] 

SHARED = {Y|YB IN} 

UNIT = type 

UNITADD = ((address[,number]),...) 



CUNUMBR = number 

specifies the hexadecimal number assigned to the control unit. You specify three 
hexadecimal digits in the range of 000 through FFF. You must assign a unique 
number to each control unit. However, you can arbitrarily assign the numbers. 
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PATH = chpid 

specifies the channel path(s) attached to the control unit. You specify one to 
four channel path identifiers for the control unit. You must specify two 
hexadecimal digits for each channel path identifier. 

Note: If you specify the control unit as shared (SHARED = Y) or shared block 
(SHARED = YB), then you cannot specify channel paths that operate in byte 
multiplexer mode for the control unit. 

PROTOCL = 

specifies the interface protocol that the control unit uses when operating with the 
channel paths specified on the PATH parameter. 

D 

specifies the D. C. interlock protocol. This protocol is the standard I/O 
interface that requires the demand response. D is the default if you do not 
code PROTOCL. 

S 

specifies the data streaming protocol at a data rate of up to 3.0 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S is valid only for a control unit that is 
attached to block-multiplexer channel paths. 

S4 

specifies the data streaming protocol at a data rate of up to 4.5 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S4 is valid only for a control unit that is 
attached to block-multiplexer channel paths. 

Note: You may specify S4 if your processor has been upgraded to support 
a data rate of 4.5 megabytes. To operate at 4.5 megabytes on a Model X 
processor, no more than two channel paths per DSE can attach to control 
units that have PROTOCL = S4. To operate at 4.5 megabytes on a 
processor that is not a Model X, the control unit can only be attached to 
channel paths with the following identifiers: 06, 07, 16, 17, 26, 27, 46, 47, 
56, 57, 66, and 67. 

Note: Incorrect specification of the PROTOCL parameter may produce 
unpredictable results. For example, if you specify S (data streaming) for a 
control unit that supports the D. C. interlock protocol, I/O requests can result in 
either detected errors (such as data overruns or interface control checks) or in 
undetected errors. 

SHARED = 

specifies the level of concurrency of I/O requests that the channel allows for the 
control unit. In 370 mode, the parameter specifies the assignments of 
subchannels. In 370-XA mode, lOCP sets the control unit type (1 or 2) 
automatically based on the SHARED parameter that you specify. See Appendix 
D for more information on specifying the SHARED parameter. (For further 
information on control unit types, see the topic "Logical Control Units" in 
Chapter 1.) 
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Y 



YB 



N 



specifies that the control unit (such as the 3803 for magnetic tape units) has 
one or both of the following attributes: 

• The control unit supports only one I/O request at a time, regardless of 
the number of I/O devices attached. 

• The control unit clears pending sense informa:tion in the control unit for 
an I/O device if the channel initiates an I/O request for another attached 
I/O device. 

For 370 mode, assigned to all the devices attached to a control unit is a 
single shared subchannel (for each attaching channel path) and the channel 
operates in selector mode. For 370-XA mode, you assign the control unit as 
type 1 and each device as a subchannel. 

In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program issues an I/O request to clear the pending sense information. 

You cannot specify SHARED = Y for control units that attach to a byte 
multiplexer channel path. 

specifies that the control unit (such as the 3258, 3272, or 3274) has one or 
both of the attributes of SHARED = Y, but supports disconnect command 
chaining (DCC) operations. 

For 370 mode, assigned to all the devices attached to a control unit is a 
single shared subchannel (for each attaching channel path)and the channel 
operates in block multiplexer mode. 

For 370-XA mode, you assign the control unit as type 1 and each device as 
a subchannel. 

In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode, if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program issues an I/O request to clear the pending sense information. 

You cannot specify SHARED = YB for control units that attach to a byte 
multiplexer channel path. 

specifies that the control unit supports multiple I/O requests concurrently 
(one for each attached I/O device). 

Each I/O device attached to the control unit is assigned a separate 
subchannel. For 370-XA mode, the control unit is assigned as type 2. 

The channel accepts and initiates one I/O request for each I/O device and 
operates in either block or byte multiplexer mode, depending on how you 
specified the attaching channel path. 
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UNIT = type 

specifies the type of control unit. You specify up to five alphanumeric 
characters that identify the type of control unit. lOCP checks only the syntax 
for alphanumeric characters. lOCP does not validate the type value. 

You must specify a type for every control unit in your I/O configuration. You 
specify a type on the UNIT parameter in one of two ways: 

• For devices that do not have a separately assigned control unit type (for 
example, when the control unit function is built into the same physical unit 
as the device), you can specify the device type on the UNIT parameter. For 
example, for the 3800 Printing Subsystem you can specify UNIT = 3800 on 
the UNIT parameter of the CNTLUNIT macro instruction (as well as 
UNIT = 3800 on the lODEVICE macro instruction). 

• For devices that do have a separately assigned control unit type, you must 
specify the specific control unit type on the UNIT parameter (such as 
UNIT = 3803). 

UNIT ADD = 

address 

specifies the unit addresses of the I/O devices that the control unit 
recognizes. You specify two hexadecimal digits in the range of 00 through 
FF. You must specify at least one unit address. A unit address need not 
represent an attached device. (For example, UNITADD = ((OA),(OB),(OF)) 
specifies that the control unit recognizes unit addresses OA,OB, and OF.) 

number 

specifies the number of sequential unit addresses recognized by the control 
unit. You specify a one-, two-, or three-digit decimal value in the range of 1 
through 256. (For example, UNITADD = ((0A,3)) specifies that the control 
unit recognizes unit addresses OA, OB, and OC.) The unit address plus the 
number of addresses must not exceed a hexadecimal address of FF. If you 
omit a number, a value of 1 is assumed. 

You can specify a maximum of eight addresses and/or sets of address and 
number values. If you do not specify the UNIT ADD parameter on the 
lODEVICE macro instruction, the unit addresses specified must include the 
device addresses (the second and third digits) specified on the ADDRESS 
parameter of the lODEVICE macro instruction for the attached devices. If you 
specify the UNIT ADD parameter on the lODEVICE macro instruction, the unit 
addresses specified must include the unit addresses specified on the UNIT ADD 
parameter for the attached devices. 

Note: See Appendix D for the exceptions and recommendations that apply to 
specific device types. 

You must specify the full range of unit addresses that the control unit can 
address whether devices are attached or not. 
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Example: The following macro instruction assigns the control unit number of lOA 
to an IBM 2821 Control Unit, names channel path 06 to which the control unit 
attaches, and defines unit addresses OA, OB, and OC that the control unit recognizes. 
D is the default for PROTOCL. 



CUIOA 


CNTLUNIT 


CUNUMBR = 10A,PATH = 06,SHARED = N, 

UNIT = 2821 ,UNITADD = ((0A,3)) 



Example: The following macro instruction assigns the control unit number of OOE 
to a 3803 Tape Control, names channel path 05 to which the control unit attaches, 
specifies the D. C. interlock protocol, and defines unit addresses 80 through 8F that 
the control unit recognizes. 



CUOOE 


CNTLUNIT 


CUNUMBR = OOE,PATH = 05,PROTOCL = D, 
SHARED = Y,UNIT = 3803,UNITADD = ((80,16)) 



Example: The following macro instruction assigns the control unit number UA to a 
control unit that the customer has named DUMMY, names two channel paths 06 
and 07 to which the control unit is attached, and defines unit addresses 90 through 
9F and AO through AF that the control unit recognizes. 



CUilA 


CNTLUNIT 


CUNUMBR = 1 1 A,PATH = (06,07),PROTOCL = D, 
SHARED = Y,UNIT = DUMMY, 
UNIT ADD = ((90, 1 6),(A0, 1 6)) 



Example: The following macro instruction assigns the control unit number of 031 
to an IBM 3272 Control Unit, names channel path 04 to which the control unit is 
attached, and defines unit addresses DO through DF that the control unit recognizes. 



CU031 


CNTLUNIT 


CUNUMBR = 03 1 ,PATH = 04,PROTOCL = D, 
SHARED = YB,UNIT = 3272, 

UNITADD = ((D0,16)) 
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ID 



ID is an optional macro instruction that describes the identification information 
printed on the IDl and ID2 hnes of the lOCP configuration report headings. It is 
also the source of the customer name (data set name) for the lOCDS that appears 
on the lOCDSM (SYS021) frame. 

See "Chapter 5. lOCP Configuration Reports" for examples of the headings used on 
the reports. 

When specified, the ID macro instruction must precede all CHPID, CNTLUNIT, 
and lODEVICE macro instructions in the input stream. You can specify the ID 
macro instruction only once in the input deck. If you do not specify the ID macro 
instruction, the IDl and ID2 Hnes of the heading do not have identifying 
information. 

The format of the ID macro instruction is: 



[symbol] 


ID 




MSGl = 'message', MSG2 = 'message' ] 
MSGl = 'message' 
MSG2 = 'message' 



MSG1 = 

specifies the identification information printed on the IDl line of the heading on 
lOCP configuration reports. The processor controller also uses the first eight 
characters of MSGl = (bytes 1 through 8) as the customer name for the lOCDS 
that appears on the lOCDSM (SYS021) frame. (For more information, see the 
operator's guide for your system console.) 

MSG2 = 

specifies the identification information printed on the ID2 line of the heading on 
lOCP configuration reports. 

'message' 

specifies a string of 1 through 64 alphanumeric characters used as identification 
information. You must enclose the string within apostrophes. Two consecutive 
apostrophes count as one character and indicate an apostrophe within the string 
(such as, MSGl = 'John's I/O Report'). 

Example: The following macro instruction defines the identification information 
printed on lines IDl and ID2 on the heading of the lOCP configuration reports. 
TPCONFIG is the customer name for the lOCDS that appears on the lOCDSM 
(SYS021) frame. 



IDOOB 


ID 


MSGl = 'TPCONFIG Configuration for Processor B', 
MSG2 = 'Revised by Plan 3' 



Chapter 2. Executing the MYS Version of IOC? 2-15 



lODEVICE 



lODEVICE, a required macro instruction, describes: 

• The I/O device address/number 

• The device characteristics 

• The control units to which the device is assigned 

An lODEVICE macro instruction used for I/O requests must specify each uniquely 
addressable I/O device in your I/O configuration. When using an input deck 
containing MVS system generation macro instructions and lOCP macro instructions, 
you can define, to MVS system generation, devices used only by processors other 
than the processor complexes listed on the cover of this manual. (See the note in the 
description of the CUNUMBR parameter on this macro instruction.) 

Note: MVS/System Product Version 1 or Version 2 does not necessarily support 
devices supported by lOCP. For a Hst of the devices supported by MVS/System 
Product Version 1, see 0S/VS2 MVS/System Product General Information Manual; 
for MVS/System Product Version 2, see MVS/System Product Version 2 General 
Information Manual. 

You can assign up to 256 devices to one channel path. You can assign one device to 
a maximum of four control units. Although you can attach a control unit to a 
maximum of four channel paths, you can only assign a device to a combined 
maximum of four channel paths. 

Each I/O device must have a unique device address/number within the I/O 
configuration. lOCP does not allow duplicate addresses. 

To assign an I/O device to both channel set and channel set 1 (for 370 mode 
channel sets), specify the device address/number on an lODEVICE macro instruction 
and the device's unit address on the CNTLUNIT macro instruction(s) that define(s) 
the control unit(s) attached to channel paths in both channel sets. (On a 
uniprocessor, MVS/370 can access only channel set 0; therefore, you must assign all 
I/O devices you want to use to channel set 0.) 

The lODEVICE macro instruction must follow any CNTLUNIT macro instructions 
that specify control units used by the device. 

The format of the lODEVICE macro instruction is: 



[symbol] 


lODEVICE 


ADDRESS = (address[,number]) 

CUNUMBR = (number[,number] .. .) 

[MODEL = model] 

[PATH = chpid] 

[TIMEOUT ={YiN}] 

UNIT = device 

[UNITADD = address] 



If you are coding the lODEVICE macro instruction for use with an MVS system 
generation, use the description of the lODEVICE macro instruction found in 
OS/VS2 System Programming Library: System Generation Reference or 
MVS/ Extended Architecture System Generation Reference. 
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If you are coding the lODEVICE macro instruction for use with the MVS 
Configuration Program (MVSCP) use the description of the lODEVICE macro 
instruction found in MVSjExtended Architecture: MVS Configuration Program 
Guide and Reference The parameters that lOCP uses are a subset of the lODEVICE 
parameters used by system generation (except the CUNUMBR, PATH, TIMEOUT, 
and UNITADD parameters, which only lOCP uses). When you use card-image 
input and specify IGNORE = YES on the PARM parameter of the JCL EXEC 
statement, lOCP checks the syntax and validity of the OPTCHAN parameter, if 
present, on the lODEVICE macro instruction. Note that lOCP allows only one 
hexadecimal digit as the keyword value for OPTCHAN. 

ADDRESS = 

address 

specifies the device address in 370 mode and the device number in 370-XA 
mode. You specify three hexadecimal digits in the range of 000 through 
FFF. 

For 370 mode operation, the first hexadecimal digit (0-F) must specify the 
channel number that corresponds to the lowest-numbered channel path to 
which the device is assigned. This channel path is the primary channel 
address for the device. 

In 370-XA mode, the first hexadecimal digit does not have to correspond to 
the 370 channel number. If you want to use the same lOCDS to operate in 
both 370 mode and 370-XA mode, specify the first hexadecimal digit for 
370-XA mode the same way you do for 370 mode. 

MVS requires that the first digit must be the same for each device on a 
single control unit or for each DASD on a single string. In all cases, specify 
a hexadecimal digit in the range of through F. 

If you do not specify the UNITADD parameter on the lODEVICE macro 
instruction, the second and third hexadecimal digits of the ADDRESS 
parameter specify the physical unit address that is transmitted on the 
channel path to select the device. You specify two hexadecimal digits in the 
range of 00 through FF. These two hexadecimal digits must match one of 
the unit addresses specified on the UNITADD parameter of the 
CNTLUNIT macro instruction that defines the control units assigned to the 
device. 

If you do specify the UNITADD parameter on the lODEVICE macro 
instruction, then the second and third digits of the ADDRESS parameter 
can have any value that follows the rules in Appendix D and makes the 
device address/number unique. The two digits specified on the UNITADD 
parameter must be the physical unit address. See Appendix D for the 
exceptions and recommendations that apply to specific device types. 

number 

specifies the number of sequential device addresses/numbers to be assigned. 
You specify a one, two, or three-digit decimal value in the range of 1 
through 256. (For example, ADDRESS = (10A,3) specifies that the device 
addresses of lOA, lOB, and IOC are assigned.) 

If you do not use the UNITADD parameter on the lODEVICE macro 
instruction, the physical unit address (second and third digits) specified on 
the ADDRESS parameter plus the number of addresses minus one must not 
exceed a hexadecimal value of FF. 
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If you do use the UNIT ADD parameter, the device address/number 
specified on the ADDRESS parameter plus the number of addresses minus 
one must not exceed a hexadecimal value of FFF. 

If you omit number (when using card-image input) and you specify 
IGNORE = NO on the FARM parameter of the JCL EXEC statement, 
lOCP assumes a default value of 1. If IGNORE = YES, lOCP assumes a 
default value of 1 except for some devices, as noted in Appendix D. 

For example, if you use card-image input and specify IGNORE = YES, 
lOCP checks the syntax of the number subparameter for the 2305 Fixed 
Head Storage and the 3838 Array Processor, but lOCP unconditionally 
assigns eight addresses to these devices. 

Each device address specified must be unique within the I/O configuration. 
lOCP does not allow duplicate addresses. 

CUNUMBR = number 

specifies the control unit numbers assigned to the control units (specified on the 
CUNUMBR parameter of the CNTLUNIT macro instruction) to which the 
device attaches. You specify three hexadecimal digits in the range of 000 
through FFF for each control unit. 

You can assign a device to a maximum of four control units. Although you can 
attach each control unit to a maximum of four channel paths, you can only 
assign a device to a combined maximum of four channel paths. 

When you attach the device to more than one control unit (for example, via a 
string switch), you must specify each control unit. 

If you attach a device to more than one control unit, all control units that attach 
to the device must: 

• Use the same address to access the device assigned to the device on the 
ADDRESS parameter of the lODEVICE macro instruction. 

• Have the same SHARED characteristic (Y, YB, or N). 

• Have the same interface protocol (D, S, or S4). 

• Not be attached to the same channel path. 

Note: Specify *** (three asterisks) instead of a number when defining, to MVS 
system generation, a device or devices used only by processors other than the 
processor complexes hsted on the cover of this manual. (You must code *** if 
you coded ** for the chpid number on the CHPID macro instruction that 
defines the channel to which you are assigning the devices.) You can code *** 
only if you use card-image input and specify IGNORE = YES on the PARM 
parameter of the JCL EXEC statement. lOCP ignores the device(s); that is, it 
does not include them in the lOCDS. 

MODEL = model 

specifies the model number, if any, for the device. You specify one or two 
alphanumeric characters that represent the model number of the device. lOCP 
only checks the syntax for alphanumeric characters. lOCP does not validate the 
model value. 

PATH = chpid 

specifies the preferred channel path. You specify two hexadecimal digits that 
must correspond to a channel path identifier of an attaching channel path. 
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In 370-XA mode, the channel subsystem always attempts to use the preferred 
channel path to initiate I/O requests. The channel subsystem will attempt to 
initiate all I/O requests for the desired device using the specified preferred 
channel path first, before it attempts to initiate requests on any of the other 
attaching channel paths. When operating in 370 mode, the processor complex 
ignores the preferred channel path. See "Preferred Path" in Chapter 1 for more 
information. 

TIMEOUT = 

specifies whether the eight-second I/O interface timeout function is to be active 
for the I/O interface tag sequences between the channel and I/O device. 

Y 

specifies that the I/O interface timeout function is to be active for all 
sequences on the I/O interface except as noted in Appendix C. With the 
timeout function active, if the I/O device fails to complete a tag sequence 
within eight seconds or a delay occurs in a dependent tag sequence that 
exceeds eight seconds, the channel terminates the I/O request to the I/O 
device and generates an interface-control-check interruption. 
TIMEOUT = Y is the default if you do not code the TIMEOUT parameter. 

N 

specifies that the I/O interface timeout function is to be inactive (timeout is 
inhibited) for some of the sequences on the I/O interface as described in 
Appendix C. With the timeout function inactive, the channel waits until the 
I/O device completes the tag sequence or initiates the next dependent 
sequence. TIMEOUT = N is not vahd for I/O devices assigned to byte 
multiplexer channel paths. 

We recommend that you specify or use the default TIMEOUT = Y for all IBM 
I/O devices. However, for certain I/O devices, normal I/O sequences sometimes 
require more than eight seconds to complete. For example, some I/O sequences 
on a channel-to-channel (CTC) adapter might require more than eight seconds 
to complete. For these devices, you may chose to specify TIMEOUT = N. See 
Appendix C for additional information about the timeout function. 

Note: When operating in 370 mode, the TIMEOUT specification for the lowest 
device address on a shared control unit (SHARED = Y or SHARED = YB) 
overrides the timeout specification of the other devices connected to the same 
control unit. For example, device lAO connects to a shared control unit and has 
TIMEOUT = Y; device lAl connects to the same control unit and has 
TIMEOUT = N. In 370 mode, both devices are fimed. In 370-XA mode, device 
lAO is timed; device lAl is not timed. 

UNIT = device 

specifies the device type. You specify up to five alphanumeric characters to 
define the device type (such as, 3330 or 2540R). lOCP only checks the syntax 
for alphanumeric characters. lOCP does not vahdate the device value. For 
certain device types (such as 3350P), lOCP takes special actions. See Appendix 
D for more information. 

UNITADD = address 

specifies the physical unit address that is transmitted on the channel path to 
select the I/O device. You specify two hexadecimal digits in the range of 00 
through FF. These two hexadecimal digits must match one of the unit addresses 
specified on the UNIT ADD parameter of the CNTLUNIT macro instruction 
that defines the control units to which the device is assigned. 
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Notes 



UNIT ADD allows you to assign a device number in the ADDRESS parameter 
on the lODEVICE macro instruction that does not have the actual physical unit 
address of the I/O device as the two rightmost digits of the device number. (The 
device number is the three hexadecimal digits specified in the ADDRESS 
parameter.) There may be situations when it is difficult or undesirable to assign 
device numbers that contain the physical unit address of the device. The 
UNITADD parameter allows you to assign a device number in the ADDRESS 
parameter on the lODEVICE macro instruction that does not have the physical 
unit address of the I/O device as the two rightmost digits of the device number. 
The UNITADD parameter that you specify becomes the physical unit address 
that the channel uses to address the selected device in both 370 and 370-XA 
mode. 

We recommend you specify the UNITADD parameter on the lODEVICE macro 
instruction only for an lOCDS that will be used exclusively for 370-XA mode 
operation. Operational and serviceability problems are Ukely to occur if you 
defined the lOCDS with UNITADD for use in 370 mode. 

If you specified a value for number in the ADDRESS parameter, that same 
number of sequential device numbers applies to the UNITADD parameter. 
However, the UNITADD parameter plus the number of device numbers (or 
device addresses) must not exceed a hexadecimal value of FF. 



• If you use the UNITADD parameter, you must follow the same rules and 
restrictions that apply to the second and third digits of the ADDRESS 
parameter. For example, notes in Appendix D that apply to the unit address 
specified on the ADDRESS parameter also apply to the unit address specified 
on the UNITADD parameter. 

• For an MVS/370 system generation if you use the UNITADD parameter, you 
cannot use a combined input deck (lOCP and MVS system generation macro 
instructions). 

• If you specify the UNITADD parameter and use the lOCDS for 370 mode 
operation, the two digits specified in the UNITADD parameter replace the two 
rightmost digits of the device address. The UNITADD parameter changes the 
device address and makes it different from the device number. For example, 
ADDRESS = 180,UNIT ADD = 90 produces a device address (370 mode) of 190 
(if the device is connected to a channel path defined for 370 mode as channel 1). 
However, the device number (370-XA mode) is still 180. Thus, messages and 
error records for the same device will be issued using different device identifiers, 
190 in 370 mode and 180 in 370-XA mode. It is also possible that messages and 
error records for a device identifier (a device address or device number) could 
actually represent more than one device. 

Example: The following macro instruction defines a 2540 Card Read Punch Model 
1 with an address of OOD. It is attached to a 2821 Control Unit that has a control 
unit number of lOA. 



DEVOOD 


lODEVICE 


ADDRESS = OOD,CUNUMBR= 10A,MODEL= 1, 
UNIT = 2540P,TIMEOUT = Y 
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Example: The following macro instruction defines eight 3330 Disk Storage Model 1 
devices. The 3830 Storage Control has been assigned control unit number 11 B and 
recognizes the device addresses/numbers of 210 through 217. 



DEV2DD 


lODEVICE 


ADDRESS = (210,8),CUNUMBR=1 IB, 
MODEL = 1 ,UNIT = 3330,TIMEOUT = Y 



Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has been assigned control unit number OOE and recognizes 
the device addresses/numbers of D80 through D87. 



DEVDTT 


lODEVICE 


ADDRESS = (D80,8),CUNUMBR = OOE, 
MODEL = 3,UNIT = 3420,TIMEOUT = Y 



Example: The following macro instruction defines eight 3420 Magnetic Tape Units 
attached to two 3803 Tape Controls via the tape switching feature. The control 
units are assigned the numbers 01 B and OIC. Both control units recognize the unit 
addresses of 40 through 47. (Note: In this case the control units must be attached to 
different channel paths to ensure that unit addresses are not dupHcated on the same 
channel path.) The channel number that corresponds to the lower numbered 
channel path to which the devices are assigned is C. 



DEVTUU 


lODEVICE 


ADDRESS = (C40,8),CUNUMBR = (01B,01C), 
MODEL = 3,UNIT = 3420,TIMEOUT = Y 



Example: The following macro instruction defines eight 3420 Magnetic Tape Units 
to MVS system generation for use only by processors other than the processor 
complexes listed on the cover of this manual. lOCP does not include the devices in 
the lOCDS. 



DEVTUX 


lODEVICE 


ADDRESS = (E80,8),CUNUMBR = ***, 
MODEL = 3, UNIT = 3420 



Example: The following macro instruction defines two 3350 I/O devices for use as 
paging devices by the 3880 Model 11 Paging Storage Subsystem. The 3880 Model 
11 Paging Storage Director has been assigned control unit number 14B. 

lOCP generates four device addresses/numbers for each 3 3 SOP (a 3350 used as a 
paging device by the 3880 Model 11): the base address as specified on the 
ADDRESS parameter, and three additional addresses at intervals of eight. 

This macro instruction causes lOCP to generate addresses 440, 448, 450, and 458 for 
base address 440, and addresses 441, 449, 451, and 459 for base address 441. 



DEV4DD 


lODEVICE 


ADDRESS = (440,2),CUNUMBR = 14B, 
UNIT = 3350P,TIMEOUT = Y 
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Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has been assigned the control unit number 530. The device 
numbers (for 370-XA mode) are 180 through 187. But the devices respond to the 
unit addresses of 90 through 97 (not 80 through 87) in both 370-XA mode and 370 
mode. Thus, the device addresses (for 370 mode) are actually 190 through 197. 



DEVIUA 


lODEVICE 


ADDRESS - (180,8),CUNUMBR = 530, 
MODEL - 3,UNIT = 3420,UNITADD = 90 
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Generating an lOCDS 



lOCP performs the following steps when you specify that you want to generate an 
lOCDS. 

Note: lOCP repeats steps 1 through 5 for each input macro instruction it reads 
(unless it finds an error as indicated in Steps 3 and 4). 

lOCP: 

1 . Reads each macro instruction from the input device. 

2. Prints each macro instruction on the output printer. 

3. Checks the syntax of each macro instruction for correct format. If it finds a 
syntax error (such as a missing parenthesis), lOCP prints an error message on 
the output printer following the macro instruction that contains the error. lOCP 
stops checking the syntax of a macro instruction when it encounters the first 
syntax error on that macro instruction. If there are two or more syntax errors 
on a single macro instruction, lOCP finds the second and following errors on 
subsequent runs. 

If lOCP finds an error in Step 3, lOCP returns to Step 1 and continues reading, 
printing, and checking the syntax of the following macro instructions, but does 
not perform any of the following steps. 

4. Checks the validity of each macro instruction. For example, lOCP checks that a 
CNTLUNIT macro instruction specified a channel path previously defined on a 
CHPID macro instruction. If it finds an error, lOCP prints an error message on 
the output printer following the macro instruction that contains the error. 

If lOCP finds an error in Step 4, lOCP returns to Step 1 and performs only 
Steps 1 through 3 for the remainder of the macro instructions. If there are two 
or more vaUdity errors in your input deck, lOCP finds the second and following 
errors on subsequent runs. 

5. Builds the appropriate identification, channel path, control unit, or I/O device 
record and enters the record into the lOCDS in storage. 

If more macro instructions remain to be read, lOCP returns to Step 1 . 

After it processes all of the input macro instructions and enters all of the records 
into the lOCDS in storage, lOCP performs Step 6. 

6. Generates the lOCDS in storage and makes additional checks. For example, 
lOCP checks that the channel numbers within a channel set are consecutive. If 
lOCP finds an error, lOCP issues an error message and then terminates. 

After lOCP has successfully generated an lOCDS in storage, lOCP performs Step 7. 

7. Produces the lOCP configuration reports of the lOCDS generated in storage. 
If requested (by a WRTCDS option other than NO), lOCP performs Step 8. 

8. Writes the generated lOCDS from storage to one or more lOCDS(s) in the 
processor controller. This step requires permission from the system operator 
(via message ICP050D) before lOCP writes to the processor controller. 
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Coding the JCL EXEC Statement for Generating an lOCDS 

On the EXEC statement, you code the name of the lOCP program on the PGM 
parameter and the following FARM options in order to generate an lOCDS. (The 
examples later in this chapter describe the JOB and DD statements for an lOCP 
job.) 

Note: The defaults (on the PARM parameter) allow you to generate an lOCDS in 
storage and produce reports, but not write to the processor controller. 



PARM = 


IGNORE = YES|NO, 




WRTCDS^YES 




Ax 




Bx 




ABx 




NO, 




LINECOUNT = n|55' 



IGNORE 



YES 



specifies that lOCP is to ignore non-IOCP input macro instructions and 
non-IOCP parameters on the lODEVICE macro instruction. Except for the 
OPTCHAN parameter, which is an MVS system generation parameter on 
the lODEVICE macro instruction, lOCP processes and prints only lOCP 
input and indicates only those errors found on lOCP macro instructions and 
parameters. If OPTCHAN is coded, lOCP checks its syntax and uses the 
OPTCHAN value to test for a path from the device(s) to the alternate 
channel by which the device(s) can be addressed. 

If columns 1 through 5 contain *IOCP, lOCP prints the comment cards. 

YES is the default if you do not code IGNORE. 

Use IGNORE = YES when you have a combined input deck; that is, the 
deck contains both MVS system generation and lOCP macro instructions. 
Otherwise, lOCP will flag MVS system generation macro instructions as 
errors and prevent the generation of an lOCDS in storage. 

Also, use IGNORE = YES when defining, to MVS system generation, 
channels and I/O devices used only by processors other than the processor 
complexes listed on the cover of this manual. When you use card-image 
input and specify IGNORE = YES, lOCP does not include these channels 
and devices if you also: 

• Code ** instead of a chpid number on the PATH parameter of the 
CHPID macro instruction. 

• Code *** instead of a number on the CUNUMBR parameter of the 
lODEVICE macro instruction. 

Note: If you use IGNORE = YES and misspell an lOCP macro instruction 
name, lOCP assumes the macro instruction is not an lOCP macro 
instruction, ignores the macro instruction, and does not indicate an error. 
For example, if you specify an lODEVICE macro instruction as IDEVICE, 
lOCP does not indicate an error and does not define the device. However, 
note that MVS system generation processing will indicate an error because a 
misspelled macro instruction name is not a valid system generation or lOCP 
macro instruction name. 
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NO 

specifies that lOCP is to process all input macro instructions and 
parameters. lOCP flags non-IOCP input as errors and also indicates errors 
found on IOC? macro instructions and parameters. IOC? prints all input, 
including all comment cards (all cards with an * in column 1 or a .* in 
columns 1 and 2). 

Use IGNORE = NO when your input deck contains only lOCP macro 
instructions, lOCP-related parameters on the lODEVICE macro instruction, 
and comment cards. 

Note: If you use a combined input deck, IGNORE = NO prevents the 
generation of an lOCDS in storage. Using IGNORE = NO causes flagging 
of the MVS system generation macro instructions as errors. If you use 
IGNORE = NO, lOCP assumes a default value of 1 when the number of 
units is not specified in the lODEVICE macro. Appendix D hsts the default 
number of units assigned by lOCP when using IGNORE = YES. If you do 
not use IGNORE = YES, be certain you have specified the correct number 
of units when you write the lOCDS. See the lODEVICE macro for other 
impUcations of the IGNORE parameter. 

WRTCDS = 

specifies specifies whether or not lOCP is to write an lOCDS generated in 
storage to one or more lOCDS(s) in the processor controller of the processor 
complex. All of the WRTCDS options except NO cause lOCP to write an 
lOCDS. 

lOCP writes the lOCDS only if: 

• It finds no errors on the input macro instructions 

• It encounters no errors during lOCP processing of the lOCDS in storage 

• The system operator grants permission in response to message ICP050D 

• You did not write-protect the lOCDS (see the lOCDSM frame) 

You request IQCP to write the lOCDS only after you have (1) checked the 
syntax of the input macro instructions, (2) generated an lOCDS in storage, (3) 
received reports on the generated lOCDS, and (4) checked to see whether or not 
the I/O configuration generated by lOCP is correct. If you want to write to an 
lOCDS that is write-protected, you must also remove the write-protection using 
the lOCDSM (SYS021) frame. 

When lOCP writes the generated lOCDS to an lOCDS in the processor 
controller, it overlays the previous configuration data in that lOCDS. The data 
in that lOCDS is lost, even if that lOCDS is the active lOCDS. (The lOCDS 
used for the last power-on reset or SYSIML CLEAR is the active lOCDS). 

The valid options for WRTCDS depend on the number of I/O configuration 
data sets that your processor complex supports: 

• For two I/O configuration data sets (LVLO and LVLl), the vaHd options are 
YES, A 1, and NO. 

• For four I/O configuration data sets, the vahd options on the A side are 
YES, Ax, and NO; on the B side they are YES, Bx, and NO. 

• For eight I/O configuration data sets, all of the options are valid. 

YES 

specifies that lOCP is to write the lOCDS generated in storage to the Al 
lOCDS (or the LVLl lOCDS) in the processor controller. 
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Ax 

specifies that lOCP is to write the Ax lOCDS (where x is 0, 1,2, or 3) 
generated in storage to the level x lOCDS in the processor controller on the 
A side. 

Bx 

specifies that lOCP is to write the Bx lOCDS (where x is 0, 1,2, or 3) 
generated in storage to the level x lOCDS in the processor controller on the 
B side. 

ABx 

specifies that lOCP is to write the x lOCDS (where x is 0, 1,2, or 3) 
generated in storage to the level x lOCDS in the processor controller on 
both the A side and the B side. 

NO 

specifies that IOC? can not write the lOCDS generated in storage to an 
lOCDS in the processor controller. 

NO is the default if you do not code WRTCDS. 

Code or use the default WRTCDS = NO when you are testing the input deck 
and do not want to write to the processor controller until you have 
successfully tested and checked the input deck. Also, you must code or use 
the default WRTCDS = NO when you are executing lOCP on a processor 
other than the processor complexes Hsted on the cover of this manual. 

LINECOUNT = 

n 

specifies the number of lines that lOCP is to print on a page of the lOCP 
output listing and configuration reports, including the heading of the report. 
You code a decimal value in the range of 10 through 99. 



55 



is the default number of lines (including the heading) that lOCP prints on a 
page of the lOCP output listing and configuration reports. 



JCL Examples of Generating an lOCDS 

Example 1: The following example shows the JCL statements used to check an 
input deck containing only lOCP macro instructions. lOCP requires the ddnames 
SYSIN for the input data set and SYSPRINT for the output data set. lOCP sends 
reports to SYSOUT. 



//lOCPl JOB REGION=3O0K 

//TESTl EXEC PGM=ICPIOCP,PARM='IGNORE=NO,WRTCDS=NO, 

// LINECOUNT=60' 

//SYSIN DD DSNAME=USER.I0CD1. CARDS, DISP=SHR 

//SYSPRINT DD SYSOUT=A,DCB=(RECFM=FA) 
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In the example: 

lOCPl specifies the JOB statement. Code parameters on the JOB statement 

required by your installation. Use a region size of 300K to ensure 
sufficient space for the job. 

TESTl specifies the EXEC statement and the program (ICPIOCP) to be 

executed. The FARM options are: IGNORE = NO, which specifies 
flagging of non-IOCP input as errors; WRTCDS = NO, which 
specifies that the lOCDS generated in storage is not to be written to 
the processor controller; LINECOUNT = 60, which specifies 60 lines 
of output on the reports lOCP produces. 

SYSIN specifies the DD statement that defines the input data set, which 

consists of macro instructions with a record length of 80 bytes. 

SYSPRINT specifies the DD statement that defines the output data set to receive 
messages and reports. (Note that lOCP records contain ANSI device 
control characters and have a length of 133 bytes.) 

Example 2: The following example shows the JCL statements used to process a 
combined input deck, generate an lOCDS, and write the generated lOCDS to the AO 
lOCDS in the processor controller. lOCP sends reports of the generated lOCDS to 
SYSOUT. 

lOCP requires the ddnames SYSIN for the input data set and SYSPRINT for the 
output data set. 



//I0CP2 JOB REGI0N=300K 

//WRITEl EXEC P6M=ICPI0CP,PARM='WRTCDS=A0' 

//SYSIN DD DSNAME=USER.I0CD2. CARDS, DISP=SHR 

//SYSPRINT DD SYSOUT=A,DCB=(RECFM=FA) 



In the example: 

IOCP2 specifies the JOB statement. Code parameters on the JOB statement 

required by your installation. Use a region size of 300K to ensure 
sufficient space for the job. 

WRITEl specifies the EXEC statement and the program (ICPIOCP) to be 

executed. The PARM options are: WRTCDS = AO, which specifies 
that the lOCDS generated in storage is to be written to the AO 
lOCDS in the processor controller; IGNORE = YES (the default), 
which specifies that lOCP is to ignore non-IOCP macro instructions 
and parameters; LINECOUNT = 55 (the default), which specifies the 
number of lines of output for each page on the configuration reports. 

SYSIN specifies the DD statement that defines the input data set, which 

consists of macro instructions with a record length of 80 bytes. 

SYSPRINT specifies the DD statement that defines the output data set to receive 
messages and reports. (Note that lOCP records contain ANSI device 
control characters and have a length of 133 bytes.) 
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Producing Configuration Reports 

lOCP performs the following steps when you request configuration reports. 

lOCP: 

• Reads one or more lOCDS(s) from the processor controller into storage. 

• Prints the lOCP configuration reports. 

If lOCP encounters any errors during processing, lOCP sends appropriate error 
messages to the output printer. For examples of lOCP configuration reports, see 
"Chapter 5. lOCP Configuration Reports". 

Coding the JCL EXEC Statement for Producing Configuration Reports 

On the EXEC statement, you code the name of the lOCP program on the PGM 
parameter and the following PARM options to produce configuration reports. (The 
example later in this chapter describes the JOB and DD statements for an lOCP 
job.) 

You must code the REPORT option in order to receive reports of an lOCDS. 



PARM = REPORT = 


(CDO 




CDl 




BOTH 




Ax 




Bx 




A 




B 




AB),LINECOUNT = n 




55 



REPORT = 

specifies one or more lOCt)S(s) to be read from the processor controller into 
storage in order to produce configuration reports. You can code more than one 
REPORT option. If you code only one option, you can omit the parentheses. 

The vaHd options for REPORT = depend on the number of I/O configuration 
data sets that your processor complex supports: 

• For two I/O configuration data sets (LVLO and LVLl), the valid options are 
CDO, AO, CDl, Al, and BOTH. 

• For four I/O configuration data sets, the vahd options on the A side are 
CDO, CDl, BOTH, Ax, and A; on the B side they are CDO. 

• For eight I/O configuration data sets, all of the options are vahd. 
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CDO 

specifies the AO lOCDS. 

CDl 

specifies the Al lOCDS. 

BOTH 

specifies both the AO and the Al lOCDS. 

Ax 

specifies the Ax lOCDS, where x is 0, 1, 2, or 3. 

Bx 

specifies the Bx lOCDS, where x is 0, 1, 2, or 3. 

A 

specifies the entire A side (the AO, Al, A2, and A3 lOCDS). 

B 

specifies the entire B side (the BO, 31, B2, and B3 lOCDS). 

AB 

specifies every lOCDS on both the A side and the B side. 

LINECOUNT = 

n 

specifies the number of lines that lOCP is to print on a page of the lOCP 
output listing and configuration reports, including the heading of the report. 
You code a decimal value in the range of 10 through 99. 

55 

is the default number of lines (including the heading) that lOCP prints on a 
page of the lOCP output hsting and configuration reports. 

Conditions for Coding the REPORT Option 

• You can code REPORT only when you execute lOCP on a 308x processor 
complex because you must read an lOCDS from the processor controller. 

« You cannot code REPORT if you code either the IGNORE or WRTCDS 
option. That is, you cannot read an input deck and generate an lOCDS (which 
includes reports of the generated lOCDS), and produce reports via the REPORT 
option in the same job. 

• You can code several REPORT options. lOCP does not allow redundant and/or 
dupHcate values. For example, 

REPORT = (A0,Al,A2,A3,BOTH,CD0,CDl,A0,B) is the same as 
REPORT = (A,B) or REPORT = AB. Regardless of the order in which you 
specify the options, the reports are always produced, if they are specified, in the 
following order: AO, Al, A2, A3, BO, .... 
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JCL Example of Producing Configuration Reports 



Example: The following example shows the JCL statements used to produce lOCP 
reports of the AO and Al lOCDS in the processor controller. lOCP sends reports to 
SYSOUT. Note that you do not need a DD statement to access an lOCDS in the 
processor controller. lOCP requires the ddname SYSPRINT for the output data set. 



//I0CP5 JOB REGI0N=300K 

//REP0RT2 EXEC PGM=ICPIOCP, PARM= ' REPORT=BOTH 

//SYSPRINT DD SYSOUT=A,DCB=(RECFM=FA) 



In the example: 

IOCP5 specifies the JOB statement. Code the parameters on the JOB 

statement required by your installation. Use a region size of 300K to 
ensure sufficient space for the job. 

REPORT2 specifies the EXEC statement and the program (ICPIOCP) to be 
executed. The PARM option of REPORT = BOTH specifies that 
both the AO and the Al lOCDS are to be read from the processor 
controller to produce reports. 

SYSPRINT specifies the DD statement that defines the output data set to receive 
messages and reports. (Note that lOCP records contain ANSI device 
control characters and have a length of 133 bytes.) 
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Return Codes 



When yoii execute the MVS version of lOCP, TOCP returns one of the following 
codes at the completion of the job. 



Return Code 
Decimal 


Return Code 
Hex 


Description/ Action 








lOCP completed the requested function 
without error. 


4 


4 


lOCP completed the requested function 
without error, but has issued one or more 
warning messages. The warning messages in 
the output listings or the reports describe the 
specific conditions. 


8 


8 


lOCP encountered an error and has 
terminated processing before completing the 
requested function. The error message in the 
output Usting describes the specific condition. 


12 


C 


lOCP terminated because the output data set 
DCB failed to open. lOCP was unable to 
print messages or reports. You must 
correctly specify the DD statement for the 
output data set. 


16 


10 


lOCP terminated because it could not obtain 
the needed storage via the GETMAIN macro 
instruction. Use a region size of 300K bytes 
(on the REGION parameter of the JOB 
statement) to ensure sufficient space for the 
job. If the region size is correct, and MVS is 
running as a guest under VM, a special 
GETMAIN from subpool 245 may have 
failed. See your System Programmer. 
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Methods of Executing the MVS Version of lOCP 

This topic suggests the steps that the installation can use to execute the MVS version 
of lOCP in order to (1) initially define and check the I/O configuration data to 
prepare for a new processor complex, and (2) subsequently redefine and replace an 
I/O configuration on an installed processor complex. 

Initial Definition of I/O Configuration Data 

Note: This example applies to releases of MVS prior to MVS SP 2.2.0. MVS SP 
2.2.0 provides the MVS Configuration Program (MVSCP) which provides functions 
that were performed by SYSGEN. See MVSjExtended Architecture: MVS 
Configuration Program Guide and Reference for information on how to use MVSCP. 

The following example describes the steps that an installation can use to initially 
define and check the I/O configuration data in order to prepare for the installation 
of a new processor complex. The example suggests that you develop a combined 
card-image input deck (consisting of lOCP and MVS system generation macro 
instructions) and check the deck on an existing system. The customer engineer (CE) 
uses this input deck to generate the I/O configuration data during the installation of 
the new processor complex. 

1 . Determine, from your physical plan, the I/O configuration requirements that 
must be met to install the processor complex. 

2. Prepare a combined input deck (containing both lOCP and system generation 
macro instructions) that defines your I/O configuration and system requirements. 
You use this deck for both lOCP execution and MVS system generation, as 
described in the following steps. (Appendix B shows a listing of a typical input 
deck containing both lOCP and system generation macro instructions.) 

Validate the lOCP macro instruction input by executing lOCP on the generating 
system before executing the complete system generation, which will use the same 
input deck. This allows you to correct lOCP-related errors in the input deck before 
doing the system generation. 

During your preparation for an MVS system generation, perform the following steps 
(3, 4, 5, and 6) after you have loaded the distribution hbraries (via the SMP 
procedure) and before you execute Stage 1 of the system generation. The 
SYS1.AOSC5 data set of the distribution hbrary (DLIB) contains the lOCP 
program. The program name is ICPIOCP. 

During the SMP procedure, lOCP is Hnk edited from the DLIB into 
SYSl.LINKLIB as an APF-authorized program (authorization code AC= 1) with 
the load module name of ICPIOCP. 

3. If you want, you can link-edit the lOCP program from the DLIB into one of 
your private libraries in the generating system. The program must be link edited 
into a single load module. The program does not need to be authorized to 
perform the rest of the steps in this example. The 15 CSECTs to be included 
are: ICPCARDS, ICPCARDX, ICPCGET, ICPCGNDS, ICPCINIT, 
ICPCIOCP, ICPCIOCU, ICPCIODV, ICPCMSG, ICPCPUT, ICPCRDDS, 
ICPCRPT, ICPCRTNS, ICPCWTDS, and ICPPCNTL. Use ICPPCNTL for 
the entry point in the ICPIOCP load module to receive control. 



Note: The lOCP program used in Step 4 does not need to be an authorized 
program. You may want to keep this non-authorized program to validate 
subsequent I/O configuration input decks. 
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4. Execute lOCP via JCL statements to validate the lOCP macro instructions. On 
the FARM parameter of the EXEC statement, use IGNORE = YES and 
WRTCDS = NO. 

5. If there are any errors in the lOCP macro instructions, correct the errors and 
rerun lOCP (Step 4). 

6. Analyze the lOCP configuration reports (produced in Step 4) to ensure that you 
defined the desired I/O configuration. If necessary, revise the lOCP macro 
instructions and rerun lOCP. 

7. Execute the MVS system generation for the MVS/System Product and use the 
input deck created in Step 2 and processed by lOCP in Step 4. 

Note; During the MVS system generation, lOCP is link edited from the DLIB 
into SYSl.LINKLIB of the generated system as an APF-authorized program 
(authorization code AC = 1) with the load module name of ICPIOCP. You can 
use this APF-authorized program to subsequently replace I/O configuration data 
in an lOCDS as described in "Subsequent Definition and Replacement of I/O 
Configuration Data". Also, for additional security, you may want to change the 
name of the lOCP program or move the program to another data set and 
password-protect or RACF-protect the data set. This added protection will 
reduce the possibility of having the I/O configuration data in an lOCDS 
inadvertently destroyed. 

8. If lOCP encounters errors during the system generation, correct the errors. If 
the errors involve lOCP-related macro instructions (CHPID or lODEVICE), 
rerun lOCP (Steps 4, 5, and 6) to ensure that the corrections have not affected 
lOCP processing. Then rerun the appropriate portions of system generation. 

9. Save the validated input deck for use by the CE during installation of the 
processor complex. 

Note: During the physical installation of the processor complex, the CE uses 
your validated input deck (with the stand-alone version of lOCP) to configure 
and test the I/O configuration for the new processor complex. "Generating an 
lOCDS on a New Processor Complex" in Chapter 4 provides an example for the 
CE. 

Subsequent Definition and Replacement of I/O Configuration Data 

Note: This example apphes to releases of MVS prior to MVS SP 2.2.0. MVS SP 
2.2.0 provides the MVS Configuration Program (MVSCP) which provides functions 
that were performed by SYSGEN. See MVS/Extended Architecture: MVS 
Configuration Program Guide and Reference. 

The following example describes the steps the installation can use to replace the 
existing I/O configuration data on a processor complex. You use this procedure 
when the I/O configuration for your processor complex changes and you need to 
execute lOCP and perform an MVS system generation. 
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You can do steps 1 through 6 on an existing system (such as a 3033) that has an 
MVS/System Product installed. 

1 . Update your combined input deck that contains the lOCP and MVS system 
generation macro instructions to reflect your new I/O configuration. 

2. Execute the MVS version of lOCP (either an APF-authorized or non-authorized 
lOCP program) to check the input deck you updated in Step 1 . On the PARM 
parameter of the EXEC statement, use the IGNORE = YES and 

WRTCDS = NO options. 

3 . If necessary, correct any errors on the lOCP macro instructions, and rerun lOCP 
(Step 2). 

4. Analyze the lOCP configuration reports (produced in Step 2) to ensure that you 
defined the desired I/O configuration. If necessary, revise the lOCP macro 
instructions and rerun lOCP (Step 2). 

5. Execute the complete system or I/O device generation using the input deck 
prepared and checked in Steps 1 through 4. 

6. If lOCP encountered errors during system generation, correct the errors. If the 
errors involve lOCP-related macro instructions (CHPID or lODEVICE), rerun 
lOCP (Steps 2, 3, and 4) to ensure that the corrections have not affected lOCP 
processing. Then rerun the appropriate portions of system generation. 

You must perform the following steps on the processor complex that is to have its 
lOCDS initialized. 

7. Execute an APF-authorized lOCP program with the IGNORE = YES and a 
WRTCDS option other than NO. lOCP writes the I/O configuration to the 
specified lOCDS in the processor controller. Note that the system operator 
must respond YES to lOCP message ICP050D before lOCP writes to the 
processor controller. 

8. Perform a power-on reset of the processor complex with the appropriate lOCDS 
specified as the source of your configuration data. You use the lOCDSM 
(SYS021) frame to select the lOCDS and the CONFIG (SYS020) frame to 
perform the power-on reset. (See the operator's guide for the system console 
that appHes to your processor complex.) 

9. Test the new configuration following the procedures established for your 
installation. 

10. If your processor complex has only a level AO and Al (LVLO and LVLl) 
lOCDS, switch them after testing the new I/O configuration. To switch data 
sets, use action 3 (SWITCH DS A/B) on the CONFIG (SYS020) frame. This 
action allows you to execute lOCP again and write to and test another I/O 
configuration in the Al lOCDS. 

11. Save the card-image input you used in Step 2 to provide a backup. 
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Chapter 3. Executing the VM Version of lOCP 



The VM version of lOCP runs under the control of: 

• the VM/System Product (VM/SP) 

• the VM/SP High Performance Option (VM/SP HPO) 

• the VM/Extended Architecture Systems Facility (VM/XA Systems Facihty) 

You invoke the VM version of lOCP in the CMS environment. The CMS lOCP 
command executes lOCP and has options that allow you to request the following 
lOCP functions: 

• Generating an lOCDS - lOCP reads, validates, and checks the syntax of the 
input macro instructions. It generates an lOCDS in storage based on the 
configuration defined by the macro instructions and produces reports of the 
lOCDS generated in storage. When requested, lOCP writes the generated 
lOCDS to one or more lOCDS(s) in the processor controller. 

• Producing Configuration Reports - lOCP reads one or more lOCDS(s) from the 
processor controller into storage and prints the lOCP configuration reports. 
(See "Chapter 5. lOCP Configuration Reports" for examples.) 

The following topics describe: 

• How to specify lOCP macro instructions 

• The two functions lOCP performs 

• The CMS lOCP command that invokes these functions (with examples) 

• The return codes lOCP can set 

• How to initially define the I/O configuration or to redefine an existing I/O 
configuration 



Copyright IBM Corp. 1980, 1989 
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Specifying lOCP Macro Instructions 



This section describes the purpose of the lOCP macro instructions and explains how 
to code them. The first topic in this section summarizes the I/O configuration rules 
that apply to the lOCP macro instructions. Subsequent topics describe the lOCP 
macro instructions in alphabetic order. 

The rules for coding the lOCP card-image macro instructions are those of assembler 
language. See "Appendix A. Coding lOCP Macro Instructions" for a summary of 
the rules for coding the macro instructions and the notation used in this book to 
illustrate the macro instructions. 

lOCP has four macro instructions: CHPID, CNTLUNIT, lODEVICE, and ID. 
lOCP requires the CHPID, CNTLUNIT, and lODEVICE macro instructions. The 
CHPID, CNTLUNIT, and lODEVICE macro instructions define respectively, the 
channel paths, control units, and I/O devices in your configuration. The ID macro 
instruction is optional. If you want specific identifying information in the heading of 
the lOCP configuration reports, code the ID macro instruction. 

The following general rules apply to the sequence of the lOCP macro instructions in 
the input file. 

• You can code the ID macro instruction only once and it must precede other 
lOCP macro instructions. 

• A CHPID macro instruction that defines the channel path must precede a 
CNTLUNIT macro instruction that refers to the channel path. 

• A CNTLUNIT macro instruction must follow the CHPID macro instruction 
that defines the channel path to which the control unit attaches. 

• An lODEVICE macro instruction must follow the CNTLUNIT macro 
instruction that defines the control unit to which the device is assigned. 

• You can insert lOCP comment cards, specified by the characters *IOCP in 
columns 1 through 5, in the input file where desired. 

We suggest that you group all CHPID macro instructions together, followed by all 
CNTLUNIT macro instructions, and then all lODEVICE macro instructions (as 
shown in Figure B-3). Or, you might group all CHPID macro instructions together, 
followed by groups of related CNTLUNIT and lODEVICE macro instructions. 

lOCP and VM/SP (or V[\/I/SP HPO) System Generation 

The information on some VM/SP (or VM/SP HPO) system generation macro 
instructions must correspond to lOCP macro instructions. Figure 3-1 shows that 
correspondence. This chapter contains detailed information about the 
correspondence between VM/SP and VM/SP HPO system generation macro 
instructions and lOCP macro instructions. 

Do not mix lOCP macro instructions and VM/SP (or VM/SP HPO) system 
generation macro instructions in the same file. You must maintain two distinct files, 
the lOCP source file and the corresponding real I/O configuration file (DMKRIO). 
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'Remote Display Stations \ 

System Generation Macro Instructions 



lOCP Macro Instructions 



1. ID macro instruction (optional) defines heading data, or titles, 

for configuration reports. lOCP allows only one ID macro instruction. 

2. CHPID macro instructions (required) define channel paths. You can 
define up to 8 channel paths on each CHPID macro instruction. 

The information on the CHPID macro instructions must correspond 
to the information on the RCHANNEL macro instructions in the 
DMKRIO file. 

3. CNTLUNIT macro instructions (required) define control units. You must 
define each control unit on a separate CNTLUNIT macro instruction. 
The information on the CNTLUNIT macro instructions must correspond 

to the information on the RCTLUNIT macro instructions in the 
DMKRIO file. 

4. lODEVICE macro instructions (required) define I/O devices. You can 
define up to 256 I/O devices on an lODEVICE macro instruction. 

The information on the lODEVICE macro instructions must 
correspond to the information on the RDEVICE macro instructions 
in the DMKRIO file. 



Figure 3-1. Correspondence between lOCP Macro Instructions and DMKRIO Macro Instructions 



Chapter 3. Executing the VM Version of lOCP 3-3 



lOCP and VM/XA Systems Facility System Generation 

The information on some VM/XA Systems Facility system generation macro 
instructions must correspond to lOCP macro instructions. Figure 3-2 shows that 
correspondence. This chapter contains detailed information about the 
correspondence between VM/XA Systems Facility system generation and lOCP 
macro instructions. 

Do not mix lOCP and VM/XA Systems Facility system generation macro 
instructions in the same file. You must maintain two distinct files, the lOCP source 
file and the corresponding real I/O configuration file (HCPRIO). 
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HCPSYS 




System Generation Macro Instructions 



lOCP Macro Instructions 



1. ID macro instruction (optional) defines heading data, or titles, 

for configuration reports. lOCP allows only one ID macro instruction. 

2. CHPID macro instructions (required) define channel paths. You can 
define up to 8 channel paths on each CHPID macro instruction. 

A VM/XA Systems Facility system generation does not use a 
corresponding macro instruction. 

3. CNTLUNIT macro instructions (required) define control units. You must 
define a control unit on a separate CNTLUNIT macro instruction. 

A VM/XA Systems Facility system generation does not use a 
corresponding macro instruction. 

4. lODEVICE macro instructions (required) define I/O devices. You can 
define up to 256 I/O devices on an lODEVICE macro instruction. 

The information on the lODEVICE macro instructions must 
correspond to the information on the RDEVICE macro instructions 
in the HCPRIO file. 



Figure 3-2. Correspondence between lOCP Macro Instructions and HCPRIO Macro Instructions 
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Summary of Configuration Rules 



Here for your convenience is a summary of the rules and restrictions described in the 
following topics: 



For channel paths 



You can specify all channel paths as block multiplexer. 

• You can specify for the A side, only channel paths 00, 01, 02, 03, 10, 11, 12, and 
13 (hex) byte multiplexer. 

• For the B side, you can specify only channel paths 40, 41, 42, 43, 50, 51, 52, and 
53 (hex) as byte multiplexer. 

• You can specify a maximum of four channel paths on each side as byte 
multiplexer. 



For control units 



You can attach a physical control unit to a maximum of four channel paths per 
system. 

You can assign a maximum of 16 control units to one channel path. 

You can attach only a nonshared control unit (specified by SHARED = N on the 
CNTLUNIT macro instruction) to a channel path that operates in byte 
multiplexer mode. 

Only a control unit attached to a block multiplexer channel path can use the 
data streaming interface protocol. That is, if PROTOCL = S or S4 on the 
CNTLUNIT macro instruction, the channel path(s) to which the control unit 
attaches must have TYPE = BL specified on the CHPID macro instruction(s). 

When you are running lOCP to verify the card-image input deck, 
(WRTCDS = NO), lOCP allows a maximum of two channel paths per data 
server element (DSE) to attach to physical control units that have 
PROTOCL = S4. Likewise, when generating an lOCDS on a Model X 
processor, lOCP allows a maximum of two channel paths per DSE to attach to 
physical control units that have PROTOCL = S4. However, when generating an 
lOCDS on a processor that is not a Model X, lOCP restricts the channel paths 
that can attach to the physical control unit that has PROTOCL = S4. This 
control unit can attach only to channel paths with the following identifiers: 06, 
07, 16, 17, 26, 27, 46, 47, 56, 57, 66, and 67. For a pictorial description of data 
server elements, see Figures 1-1 and 1-2 in Chapter 1. 
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For I/O devices 



The maximum number of I/O devices is 4080. 

The sum of the number of I/O devices plus the number of logical control units 
cannot exceed 4096. 

You can assign a maximum of 256 I/O devices to one channel path. 

You can assign a device to a maximum of four control units. 

When you assign a device to more than one control unit, each control unit must: 
(1) recognize the same unit address for the device, (2) not be attached to the 
same channel path, and (3) have the same shared characteristics and use the 
same interface protocol. 

You can only assign a device to a combined maximum of four channel paths 
(even though you can assign a device to up to four control units and you can 
attach a control unit to up to four channel paths). 

You cannot assign a device that has the I/O interface timeout function inhibited 
to a channel path that operates in byte multiplexer mode. 

Each I/O device must have a unique device address/number within the I/O 
configuration. lOCP does not allow duplicate device addresses/numbers. 



For 370-XA mode 



If you plan to create an lOCDS for VM/SP or VM/SP HPO and the VM/XA 
Systems FaciUty or another operating system that supports extended architecture, the 
following apply: 

• If you code a file of lOCP macro instructions for the 370 level of lOCP, you can 
use the same file as input to create a 370/370-XA lOCDS. (However, the 
operating system that supports extended architecture may not support all of the 
defined devices. 

• You can define a channel path and its attached I/O devices exclusively for 
370-XA mode. To do this, remove the channel number and channel set for that 
channel path from the CHPID macro instruction. 

• The PATH parameter on the lODEVICE macro instruction specifies a preferred 
path. The preferred path is an optional parameter used only for 370-XA mode 
operation. 



► 
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CHPID 



CHPID, a required macro instruction, describes: 

• The characteristics of channel paths 

• The correspondence of channel paths to channel numbers and channel sets 

You must specify each channel path in your I/O configuration on a CHPID macro 
instruction to use the channel path. You can specify up to eight channel paths on 
one CHPID macro instruction. 

The CHPID macro instruction must follow the ID macro instruction (if you 
specified the ID macro instruction). The CHPID macro instruction must precede any 
CNTLUNIT macro instructions that refer to the channel path. 

The format of the CHPID macro instruction is: 



[symbol] 


CHPID 


PATH = ((chpid number[,channel number 

[,channel set]]),...) 

TYPE={BL|BY} 



PATH = 

specifies one or more channel path identifiers. If you use the devices on a 
channel path in 370 mode, you must specify the channel path's corresponding 
channel number. Optionally, you may specify the channel path's associated 
channel set. You can specify a maximum of eight channel paths on one CHPID 
macro instruction. If you specify more than one channel path on a macro 
instruction, all channel paths must have the same TYPE characteristic. You 
cannot specify a channel set without specifying a channel number. 

chpid number 

specifies the channel path identifier. For the A side, you must specify two 
hexadecimal digits in the range of 00 through 07, 10 through 17, or 20 
through 27. (Channel paths 10 through 17 and 20 through 27 are optional 
by model.) For the B side, you must specify two hexadecimal digits in the 
range of 40 through 47, 50 through 57, or 60 through 67. 

channel number 

specifies the channel number that corresponds to the channel path when the 
processor complex operates in 370 mode. You specify one hexadecimal digit 
in the range of through F. Channel numbers must be unique and 
consecutive within a channel set. 

To specify a channel set, you must specify a channel number. If you do not 
specify the channel number, you cannot access the devices attached to the 
channel path when the processor complex operates in 370 mode. 

For a system on which you generate VM/SP or VM/SP HPO: To code the 
channel number, first find the real address of the channel as specified on the 
ADDRESS parameter of the RCHANNEL macro instruction in the 
DMKRIO file. This value is the channel number. 



3-8 lOCP User's Guide and Reference 



For example, the following macro instruction was coded for the DMKRIO 
file: 



RCHANNEL ADDRESS=2, . . . 



The corresponding lOCP macro instruction is: 



CHPID PATH=((17,2,0)),.. 



channel set 

specifies the channel set used for 370 mode. You specify a value of or 1 
for the channel set. If you do not specify a channel set, lOCP assigns the 
channel path to channel set 0. On a processor complex with both an A side 
and a B side, each side has two channel sets (0 and 1) in 370 mode. 

On the uniprocessors, VM/SP and VM/SP HPO can access only channel 
paths assigned to channel set 0. Therefore, you must either specify a value 
of or accept the default of 0. (You can assign channel paths to channel set 
1; however, neither VM/SP and VM/SP HPO, nor any of their virtual 
machines, can access these channel paths on a uniprocessor.) A channel set 
cannot have more than 16 channel paths assigned to it. The two channel 
sets (0 and 1) can have a maximum combined total of 24 channel paths on 
each side. (For example, 1 6 channel paths assigned to channel set and 8 
channel paths assigned to channel set 1, or 12 channel paths assigned to 
channel set and 12 channel paths assigned to channel set 1.) For the 
processor complex, you must assign consecutive channel numbers within a 
channel set. (For example, channel numbers 0, 1, 2, 3, 4, 5, or channel 
numbers 8, 9, A, B, C, D.) The channel path identifiers do not need to be 
consecutive. For a uniprocessor, processor 2 (the only processor) always 
connected to channel set at power-on reset, SYSIML or SYSIML 
CLEAR. For a processor complex with more than one processor, channel 
set connection at power-on reset, SYSIML or SYSIML CLEAR depends on 
whether the processor complex has one or both processors configured. 
When the processor complex has both processors configured, channel set 
connects to processor 0, and channel set 1 connects to processor 2. (If the 
processor complex has a B side, channel set on the B side connects to 
processor 1, and channel set 1 on the B side connects to processor 3.) When 
the processor complex subsequently resets (such as a system reset or load), 
channel set reconnects to processor (or processor 1 on the B side) and 
channel set 1 reconnects to processor 2 (or processor 3 on the B side). 
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If you remove either processor from the processor complex (the processor 
fails or you take it offline), channel set and channel set 1 both remain 
configured. However when you remove a processor, a subsequent reset 
causes the connection of channel set to the remaining processor on that 
side. The reset does not connect channel set 1, but you can connect channel 
set 1 after IPL by activating channel set switching. Therefore, we 
recommend that you assign critical asymmetrically attached devices (such as 
the operator's console) to a channel path assigned to channel set 0. 

TYPE = 

specifies the mode of I/O operation for the channel path. If you specify more 
than one channel path on a macro instruction, all channel paths must have the 
same TYPE characteristic. 

BL 

specifies that the channel path is a block multiplexer channel, which operates 
in burst mode only and allows multiplexing between blocks. You can 
specify TYPE = BL for all channel paths. 

BY 

specifies that the channel path is a byte multiplexer channel, which operates 
in burst mode or byte-interleave mode, depending on the attached control 
unit. You can specify TYPE = BY for only channel paths 00 through 03 and 
10 through 13 (hex) on the A side, and for channel paths 40 through 43 and 
50 through 53 (hex) on the B side. You can specify a maximum of four 
channel paths on each side as TYPE = BY. 

For a system on which you generate VM/SP or VM/SP HPO: Code TYPE = BL on 
the CHPID macro instruction for CHTYPE = SELECTOR on the RCHANNEL 
macro instruction in the DMKRIO file. Although SELECTOR has no 
corresponding value on the CHPID macro instruction, the channel operates in the 
selector mode if you code SHARED = Y on the CNTLUNIT macro instruction. See 
the description of the CNTLUNIT macro instruction in this chapter. 

Example: The following macro instruction (named CHSETl) defines three channel 
paths (hex 15, 16, and 17) with their corresponding channel numbers (hex 8, 9, and 
A) in channel set 1. The channel paths are to operate in block multiplexer mode. 



CHSETl 


CHPID 


PATH = ((15,8,1),(16,9,1),(**,A,1)),TYPE = BL 



Note that the three channel path identifiers are unique numbers arbitrarily assigned. 

Example: The following macro instruction (named CHP17) defines channel path 17. 
The channel path operates in block multiplexer mode. Because you did not specify a 
channel number, the processor complex can access the devices attached to this 
channel path only when it operates in 370-XA mode. 



CHP17 


CHPID 


PATH = 17,TYPE = BL 
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CNTLUNIT 



CNTLUNIT, a required macro instruction, describes: 

• The characteristics of the control unit 

• The channel paths to which the control unit attaches 

• The unit addresses the control unit recognizes 

You must specify each physical control unit in your I/O configuration in a separate 
CNTLUNIT macro instruction to use the control unit. This requirement includes 
control units residing either in the same physical unit as an I/O device or another 
control unit. 

You can attach a control unit to a maximum of four channel paths. You can assign 
a maximum of 16 control units to one channel path. 

See Appendix D for a list of control unit types and their characteristics. 

Based on information in the CNTLUNIT macro instructions, lOCP constructs 
logical control units for the channel subsystem to use when the processor runs in 
370-XA mode. A logical control unit is a logical representation of one to four 
physical control units. lOCP builds a logical control unit for: 

• Each control unit with no devices or no devices shared with other control units. 

• Each group of two to four control units that share devices between them. 

The channel subsystem uses the logical control units for queuing I/O requests for the 
devices attached to the associated physical control units. There is one I/O request 
queue for each logical control unit. The channel subsystem queues all I/O requests 
for all devices in the logical control unit (all the devices attached to the set of 
physical control units in the logical control unit) to the same I/O request queue. 

lOCP also estabhshes a rotation order for the channel paths associated with each 
logical control unit. When initiating I/O requests queued to the logical control unit, 
the channel subsystem uses this rotation order to determine the sequence for 
selecting channel paths. The section "Rotation Algorithm" in Chapter 1 describes 
how lOCP estabUshes the rotation order of the channel paths. 

The CNTLUNIT macro instruction must follow any CHPID macro instructions that 
specify channel paths used by the control unit. The CNTLUNIT macro instruction 
must precede any lODEVICE macro instructions that refer to the control unit. 

The format of the CNTLUNIT macro instruction is: 



[symbol] 


CNTLUNIT 


CUNUMBR = number 

PATH-(chpid[,chpid]...) 

[PROTOCL = {D|S|S4}] 

SHARED = {Y|YB|N} 

UNIT = type 

UNITADD = ((address[,number]),...) 



CUNUMBR = number 

specifies the hexadecimal number assigned to the control unit. You specify three 
hexadecimal digits in the range of 000 through FFF. You must assign each 
control unit a unique number. You can arbitrarily assign the numbers. 
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PATH = chpid 

specifies the channel path(s) attached to the control unit. You specify one to 
four channel path identifiers for the control unit. You must specify two 
hexadecimal digits for each channel path identifi^er. 

Note: If you specify the control unit as shared (SHARED = Y) or shared block 
(SHARED = YB), then you cannot specify channel paths that operate in byte 
multiplexer mode for the control unit. 

For a system on which you generate VM/SP or VM/SP HPO: The PATH 

parameter corresponds to information found on the ADDRESS parameter of the 
RCTLUNIT macro instruction in the DMKRIO file. 

The leftmost digit of the ADDRESS parameter of the RCTLUNIT macro 
instruction is the channel address of the control unit. When you code the 
CHPID macro instruction, you use the channel address for the channel number. 

Find the channel path identifier that you coded with the channel number on the 
CHPID macro instruction. Code this value for the PATH parameter. 

For example, the following RCTLUNIT macro instruction resides in DMKRIO: 

\ 



RCTLUNIT ADDRESS=4A0,... 



The channel address is 4. The CHPID coded for channel address 4 could be: 



CHPID PATH=((12,4,0)),... 



The channel path identifier you need for the PATH parameter on the 
CNTLUNIT macro instruction is 12. 



CNTLUNIT 



,PATH=12,.. 



PROTOCL 



J1UCJL = 

specifies the interface protocol that the control unit uses when operating with the 
channel paths specified on the PATH parameter. 



D 



specifies the D. C. interlock protocol. This protocol is the standard I/O 
interface that requires the demand response. D is the default if you do not 
code PROTOCL. 



specifies the data streaming protocol at a data rate of up to 3.0 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S is valid only for a control unit that is 
attached to block-multiplexer channel paths. 
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S4 

specifies the data streaming protocol at a data rate of up to 4.5 megabytes. 
This protocol does not require the demand response but continues at the 
rate governed by the control unit. S4 is valid only for a control unit that is 
attached to block-multiplexer channel paths. 

Note: You may specify S4 if your processor has been upgraded to support 
a data rate of 4.5 megabytes. To operate at 4.5 megabytes on a Model X 
processor, no more than two channel paths per DSE can attach to control 
units that have PROTOCL = S4. To operate at 4.5 megabytes on a 
processor that is not a Model X, the control unit can only be attached to 
channel paths with the following identifiers: 06, 07, 16, 17, 26, 27, 46, 47, 
56, 57, 66, and 67. 

Note: Incorrect specification of the PROTOCL parameter may produce 
unpredictable results. For example, if you specified S or S4 (data streaming) for 
a control unit that supports the D.C. interlock protocol, I/O requests can result 
in either detected errors (such as data overruns or interface control checks) or 
undetected errors. 

SHARED = 

specifies the level of concurrency of I/O requests that the channel allows for the 
control unit. In 370 mode, the parameter specifies how to assign subchannels. 
In 370-XA mode, lOCP sets the control unit type (1 or 2) automatically based 
on the SHARED parameter that you specify. See Appendix D for more 
information on specifying the SHARED parameter. (For further information on 
control unit types, see the topic "Logical Control Units" in Chapter 1.) 

Y 

specifies that the control unit (such as the 3803 for magnetic tape units) has 
one or both of the following attributes: 

• The control unit supports only one I/O request at a time, regardless of 
the number of I/O devices attached. 

• The control unit clears pending sense information in the control unit for 
an I/O device if the channel initiates an I/O request for another attached 
I/O device. 

For 370 mode, assigned to all the devices attached to the control unit is a 
single shared subchannel (for each attaching channel path) and the channel 
operates in selector mode. 

For 370-XA mode, you assign the control unit as type 1 and each device as 
a subchannel. 

In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode, if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program has issued an I/O request to clear the pending sense information. 

You cannot specify SHARED = Y for control units that attach to a byte 
multiplexer channel path. 
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YB 

specifies that the control unit (such as the 3258, 3272, or 3274) has one or 
both of the attributes of SHARED = Y, but supports disconnect command 
chaining (DCC) operations. 

For 370 mode, assigned to all the devices attached to the control unit is a 
single shared subchannel (for each attaching channel path) and the channel 
operates in block multiplexer mode. 

For 370-XA mode, you assign the control unit as type 1 and each device as 
a subchannel. 

In both modes, the channel ensures processing of only one I/O request at a 
time for all devices sharing the control unit. For 370-XA mode, if sense 
information is pending in the control unit for an I/O device attached to the 
control unit, the channel ensures that I/O requests for other I/O devices 
attached to the control unit are not initiated until the system control 
program has issued an I/O request to clear the pending sense information. 

You cannot specify SHARED = YB for control units that attach to a byte 
multiplexer channel path. 

N 

specifies that the control unit supports multiple I/O requests concurrently 
(one for each attached I/O device). 

Each I/O device attached to the control unit is assigned a separate 
subchannel. For 370-XA mode, the control unit is assigned as type 2. 

The channel accepts and initiates one I/O request for each I/O device and 
operates in either block or byte multiplexer mode, depending on how you 
specify the attaching channel path. 

UNIT = type 

specifies the type of control unit. You specify up to five alphanumeric 
characters that identify the type of control unit. lOCP only checks the syntax 
for alphanumeric characters. lOCP does not vahdate the type value. 

You must specify a type for every control unit in your I/O configuration. You 
specify a type on the UNIT parameter in one of two ways: 

• For devices that do not have a separately assigned control unit type (for 
example, when the control unit function is built into the same physical unit 
as the device), you can specify the device type on the UNIT parameter. For 
example, for the 3800 Printing Subsystem you can specify UNIT = 3800 on 
the UNIT parameter of the CNTLUNIT macro instruction (as well as 
UNIT = 3800 on the lODEVICE macro instruction) 



• 



For devices that do have a separately assigned control unit type, you must 
specify the specific control unit type on the UNIT parameter (such as 
UNIT = 3803) 

For a system on which you generate VM/SP or VM/SP HPO: The UNIT 

parameter is the same as the CUTYPE parameter on the RCTLUNIT macro 
instruction in the DMKRIO file. For example, the following macro instruction 
appears in the DMKRIO file: 



RCTLUNIT ...,CUTYPE=3811 
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The corresponding lOCP macro instruction is: 



CNTLUNIT ...,UNIT=3811,... 



UNIT ADD = 

address 

specifies the unit addresses of the I/O devices that the control unit 
recognizes. You specify two hexadecimal digits in the range of 00 through 
FF. You must specify at least one unit address. A unit address need not 
represent an attached device. (For example, UNITADD = ((OA),(OB),(OF)) 
specifies that the control unit recognizes unit addresses OA, OB, and OF.) 

number 

specifies the number of sequential unit addresses recognized by the control 
unit. You specify a one-, two-, or three-digit decimal value in the range of 1 
through 256. (For example, UNITADD = ((0A,3)) specifies that the control 
unit recognizes unit addresses OA, OB, and OC.) The unit address plus the 
number of addresses must not exceed a hexadecimal address of FF. If 
number is omitted, a value of 1 is assumed. 

You can specify a maximum of eight addresses and/or sets of address and 
number values. If you do not specify the UNITADD parameter on the 
lODEVICE macro instruction, the unit addresses specified must include the unit 
addresses (the second and third digits) specified on the ADDRESS parameter of 
the lODEVICE macro instruction for the attached devices. If you specify the 
UNITADD parameter on the lODEVICE macro instruction, the unit addresses 
specified must include the unit addresses specified on the UNITADD parameter 
for the attached devices. 

Note: See Appendix D for the exceptions and recommendations that apply to 
specific device types. 

You must specify the full range of unit addresses that the control unit can 
address whether the devices are attached or not. 

For a system on which you generate VM/SP or VM/SP HPO: The UNITADD 

parameter corresponds to information found on the ADDRESS parameter and 
the FEATURE parameter of the RCTLUNIT macro instruction in the 
DMKRIO file. The address portion of UNITADD is the same number as the 
two rightmost digits of the ADDRESS parameter on the RCTLUNIT macro 
instruction. The number portion of UNITADD is the same as the FEATURE 
number. 

For example, the RCTLUNIT macro instruction is: 



RCTLUNIT ADDRESS=4A0, . . . , FEATURE=16-DEVICE 
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The corresponding CNTLUNIT macro instruction is: 



CNTLUNIT ...,UNITADD=((A0,16)) 



For the RCTLUNIT macro instruction, the default FEATURE number is 8. 
Always code 8 as the number portion of UNIT ADD = if you do not explicitly 
code the FEATURE parameter on the RCTLUNIT macro instruction. 

Example: The following macro instruction assigns the control unit number of lOA 
to an IBM 2821 Control Unit, names channel path 06 as the channel path to which 
the control unit attaches, and defines unit addresses OA through OC as recognized by 
the control unit. D is the default for PROTOCL.^ 



CUIOA 


CNTLUNIT 


CUNUMBR = 10A,PATH = 06,SHARED = N, 
UNIT = 282 1,UNITADD = ((0A,3)) 



Example: The following macro instruction assigns the control unit number of OOE 
to a 3803 Tape Control, names channel path 05 as the channel path to which the 
control unit attaches, specifies the D. C. interlock protocol, and defines unit 
addresses 80 through 8F as recognized by the control unit. 



CUOOE 


CNTLUNIT 


CUNUMBR = OOE,PATH = 05,PROTOCL = D, 
SHARED = Y,UNIT = 3803,UNITADD = ((80,16)) 



Example: The following macro instruction assigns the control unit number 11 A to a 
control unit that the customer has named DUMMY, names two channel paths 06 
and 07 as the channel paths to which the control unit attaches, and defines unit 
addresses 90 through 9F and AO through AF as recognized by the control unit. 



CUllA 


CNTLUNIT 


CUNUMBR = 1 1 A,PATH = (06,07),PROTOCL = D, 
SHARED = Y,UNIT = DUMMY, 
UNITADD = ((90, 1 6),(A0, 1 6)) 



Example: The following macro instruction assigns the control unit number of 031 
to an IBM 3272 Control Unit, names channel path 04 as the channel path to which 
the control unit attaches, and defines unit addresses DO through DF as recognized 
by the control unit. 



CU031 


CNTLUNIT 


CUNUMBR = 03 1 ,PATH = 04,PROTOCL = D, 
SHARED == YB,UNIT = 3272, 
UNITADD = ((D0,16)) 
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ID 



ID is an optional macro instruction that describes the identification information 
printed on the IDl and ID2 hnes of the lOCP configuration report headings. It is 
also the source of the customer name (data set name) for the lOCDS that appears 
on the lOCDSM (SYS021) frame. 

See "Chapter 5. lOCP Configuration Reports" for examples of the headings used on 
the reports. 

When specified, the ID macro instruction must precede all CHPID, CNTLUNIT, 
and lODEVICE macro instructions in the input file. You can specify the ID macro 
instruction only once in the input file. If you do not specify the ID macro 
instruction, lOCP prints no identifying information on the IDl and ID2 lines of the 
heading. 

The format of the ID macro instruction is: 



[symbol] 


ID 




MSGl = 'message',MSG2 = 'message' 
MSG1 = 'message' 
MSG2 = 'message' 





MSG1 = 

specifies the identification information printed on the IDl line of the heading on 
lOCP configuration reports. The processor controller also uses the first eight 
characters of MSGl = (bytes 1 through 8) as the customer name for the lOCDS 
that appears on the lOCDSM (SYS021) frame. (For more information, see the 
operator's guide for your system console.) 

MSG2 = 

specifies the identification information printed on the ID2 line of the heading on 
lOCP configuration reports. 

'message' 

specifies a string of 1 to 64 alphanumeric characters for use as identification 
information. You must enclose the string within apostrophes. Two consecutive 
apostrophes count as one character indicating an apostrophe within the string 
(such as, MSGl = 'John' ' s I/O Report ' ). 

Example: The following macro instruction defines the identification information 
printed on lines IDl and ID2 of the lOCP configuration report headings. 
TPCONFIG is the customer name for the lOCDS that appears on the lOCDSM 
(SYS021) frame. 



IDOOB 


ID 


MSGl = 'TPCONFIG Configuration for Processor B', X 

MSG2 = 'Revised by Plan 3' 
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lODEVICE 



lODEVICE, a required macro instruction, describes: 

• The I/O device address/number 

• The device characteristics 

• The control units to which the device is assigned 

You must specify each uniquely addressable I/O device in your I/O configuration on 
an lODEVICE macro instruction to use the device for I/O requests. 

See Appendix D for a list of I/O device types and their characteristics. 

Note: VM/SP, VM/SP HPO, or the VM/XA Systems Facility does not necessarily 
support devices supported by lOCP. For a list of the devices supported by VM/SP, 
see the latest edition of IBM Virtual Machine! System Product General Information 
Manual; for VM/SP HPO, see the IBM VM/SP High Performance Option General 
Information Manual. For a list of devices supported by the VM/XA Systems 
Facility, see the Virtual Machine /Extended Architecture Systems Facility: General 
Information Manual. 

You can assign up to 256 devices to one channel path. You assign one device to a 
maximum of four control units. Although you can attach a control unit to a 
maximum of four channel paths, you can assign a device only to a combined 
maximum of four channel paths. 

Each I/O device must have a unique device address/number within the I/O 
configuration. lOCP does not allow duplicate addresses. 

To assign an I/O device to both channel set and channel set 1 (for 370 mode 
channel sets), specify the device address/number on an lODEVICE macro instruction 
and the device's unit address on the CNTLUNIT macro instruction(s) that define(s) 
the control unit(s) attached to channel paths in both channel sets. (On a 
uniprocessor, VM/SP and VM/SP HPO can access only channel set 0; therefore, you 
must assign all I/O devices you want to use to channel set 0.) 

The lODEVICE macro instruction must follow any CNTLUNIT macro instructions 
that specify control units used by the device. 

The format of the lODEVICE macro instruction is: 



[symbol] 


lODEVICE 


ADDRESS = (address[,number]) 

CUNUMBR = (number [,number]...) 

[MODEL = model] 

[PATH = chpid] 

[TIMEOUT = {r|N}] 

UNIT = device 

[UNITADD = address] 



ADDRESS = 

address 

specifies the device address in 370 mode and the device number in 370-XA 
mode. You specify three hexadecimal digits in the range of 000 through 
FFF. 
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For 370 mode operation, the first hexadecimal digit (0-F) must specify the 
channel number that corresponds to the lowest-numbered channel path 
assigned to the device. This channel path is the primary channel address for 
the device. 

In 370-XA mode, the first hexadecimal digit does not have to correspond to 
the 370 channel number. If you want to use the same lOCDS to operate in 
both 370 mode and 370-XA mode, specify the first hexadecimal digit for 
370-XA mode the same way you do for 370 mode. In all cases, specify a 
hexadecimal digit in the range of through F. 

If you do not specify the UNIT ADD parameter on the lODEVICE macro 
instruction, the second and third hexadecimal digits of the ADDRESS 
parameter specify the physical unit address that is transmitted on the 
channel path to select the device. You specify two hexadecimal digits in the 
range of 00 through FF. These two hexadecimal digits must match one of 
the unit addresses specified on the UNIT ADD parameter of the 
CNTLUNIT macro instruction that defines the control units assigned to the 
device. 

If you do specify the UNIT ADD parameter on the lODEVICE macro 
instruction, the second and third digits of the ADDRESS parameter can be 
any value that follows the rules in Appendix D and makes the device 
address/number unique. See Appendix D for the exceptions and 
recommendations that apply to specific device types. 

number 

specifies the number of sequential device addresses/numbers assigned to the 
devices. You specify a one, two, or three-digit decimal value in the range of 
1 through 256. (For example, ADDRESS = (10A,3) specifies that the device 
addresses of lOA, lOB, and IOC are assigned.) 

If you do not use the UNIT ADD parameter on the lODEVICE macro 
instruction, the unit address (second and third digits) specified on the 
ADDRESS parameter plus the number of addresses minus one must not 
exceed a hexadecimal value of FF. 

If you do use the UNIT ADD parameter, the device address/number 
specified on the ADDRESS parameter plus the number of addresses minus 
one must not exceed a hexadecimal value of FFF. 

If you omit number (when using file input) and you specify NOIGNORE on 
the lOCP command, lOCP assumes a default value of 1 . If you specify 
IGNORE, lOCP assumes a default value of 1 except for some devices, as 
noted in Appendix D. 

For example, if you use file input and specify IGNORE, lOCP checks the 
syntax of the number subparameter for the 2305 Fixed Head Storage and 
the 3838 Array Processor, but lOCP unconditionally assigns eight addresses 
to these devices. 

Each device address specified must be unique within the I/O configuration. 
lOCP does not allow dupUcate addresses. 

Note: See Appendix D for the exceptions and recommendations that apply to 
specific device types. 
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For a system on which you generate VM/SP or VM/SP HPO: The 

ADDRESS = (address", number") parameter on the lODEVICE macro 
instruction in the lOCP input file has the same value as the 
ADDRESS = cuu|(cuu,nn) parameter on the RDEVICE macro instruction in the 
DMKRIO file. 

For example, this RDEVICE macro instruction is in the DMKRIO file: 



RDEVICE ADDRESS=(018,7),... 



The corresponding lODEVICE macro instruction is: 



lODEVICE ADDRESS=(018,7) 



For a system on which you generate the VM/XA Systems Facility: The 

ADDRESS = (address[,number]) parameter on the lODEVICE macro 
instruction in the lOCP input file has the same value as the 
DEVNO = rdevnoi(rdevno,nnn) parameter on the RDEVICE macro instruction 
in the HCPRIO file. 

For example, this RDEVICE macro instruction is in the HCPRIO file: 



RDEVICE DEVNO=(190,4),... 
The corresponding lODEVICE macro instruction is: 

r 

lODEVICE ADDRESS=(190,4),... 



CUNUMBR = number 

specifies the control unit numbers assigned to the control units attached to the 
device. You specify three hexadecimal digits in the range of 000 through FFF 
for each control unit. 

You can assign a device to a maximum of four control units. Although you can 
attach each control unit to a maximum of four channel paths, you can assign a 
device only to a combined maximum of four channel paths. 

When you attach the device to more than one control unit (for example, via a 
string switch), you must specify each control unit. 



3-20 lOCP User's Guide and Reference 



If you attach a device to more than one control unit, all control units that attach 
to the device must: 

• Use the same unit address to access the device. 

• Have the same SHARED characteristic (Y, YB, or N). 

• Have the same interface protocol (D, S, or S4). 

• Not be attached to the same channel path. 

For a system on which you generate VM/SP or VM/SP HPO: To code the 
control unit number, you must make a number of cross-references between the 
lODEVICE macro instruction and the RDEVICE macro instruction in the 
DMKRIO file. 

Find the RDEVICE macro instruction for this device in the DMKRIO file. The 
leftmost digit on the ADDRESS = cuu parameter of this macro instruction is the 
channel address to which the device attaches. The two rightmost digits represent 
the unit address transmitted on the channel path to select the device. 

Find the CHPID macro instruction coded for the channel address found in the 
RDEVICE macro instruction. Use the channel path identifier from this CHPID 
macro instruction and the unit address from the RDEVICE macro instruction 
for the next cross-reference. 

Find the CNTLUNIT macro instruction that has (1) a channel path that 
matches your channel path identifier and (2) a unit address that matches the unit 
address on the RDEVICE macro instruction. Use the value coded for the 
CUNUMBR parameter on the CNTLUNIT macro instruction for the control 
unit number on the lODEVICE macro instruction. 

For example, the RDEVICE macro instruction for a 3330 magnetic disk could 
be: 



RDEVICE ADDRESS=(350,8) ,DEVTYPE=3330, . . . 



The channel address to which this device attaches is 3. The CHPID macro 
instruction coded for this channel address is: 



CHPID PATH=((03,3,0)),... 



The channel path identifier is 03 in this case. In the above RDEVICE macro 
instruction, the unit address is 50. The CNTLUNIT macro instruction with a 
channel path 03 and unit address 50 is: 



CNTLUNIT CUNUMBR=G32,PATH=(G3) ,. . . ,UNITADD=((50,8)) 
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The CUNUMBR parameter on the lODEVICE macro instruction should be 
032: 



lODEVICE ADDRESS=(350,8) ,CUNUMBR=032, . . . ,UNIT=3330 



For a system on which you generate the VM/XA Systems Facility; To code the 
control unit number for a device, you must find the correct CNTLUNIT macro 
instruction. 

When you generate an operating system that supports extended architecture, the 
device number for a given device does not need to correspond to either a 
channel path identifier or the unit address by which the control unit recognizes 
the device. You must know the following about your hardware I/O 
configuration: 

• What channel path identifier the device and its control unit are attached to. 

• How the control unit recognizes the device, that is, by what unit address. 

Find the CNTLUNIT macro instructions that has (1) a channel path that 
matches your channel path identifier to which the device and control unit are 
attached and (2) a unit address that matches the unit address by which the 
control unit recognizes the device. Use the value coded for the CUNUMBR 
parameter on the CNTLUNIT macro instruction for the control unit number on 
the lODEVICE macro instruction. 

For example, eight 3330 magnetic disks and their control unit are attached to 
channel path identifier 07. The control unit recognizes the disks as attached at 
unit addresses 40 through 47. 

However, the RDEVICE macro instruction for this group of magnetic disks 
could be: 



RDEVICE DEVN0=(350,8) ,DEVTYPE=3330 



The device numbers for these disks range from 350 to 357. 

The CHPID macro instruction coded for the channel path identifier is: 



CHPID PATH=((07,6,0)),.... 



The channel path identifier is 07; it corresponds to channel 6 and to channel set 
when the processor complex operates in 370 mode. 
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The physical unit addresses of these devices are 40 through 47. The 
CNTLUNIT macro instruction that has channel path 07 and unit addresses 
ranging from 40 to 47 is: 



CNTLUNIT CUNUMBR=G32,PATH=(07) , . . . . ,UNITADD=( (40,8) ; 



The CUNUMBR parameter on the lODEVICE macro instruction should be 
032: 



lODEVICE ADDRESS=(350,8) ,CUNUMBR=032, UNIT=3330,UNITADD=4O 



(The UNITADD parameter on the lODEVICE macro instruction has the same 
same number of unit addresses (8) as the number specified in the ADDRESS 
parameter.) 

Note: This example uses the UNITADD parameter that allows you to define 
device numbers (350 to 357) that do not contain their physical unit addresses (40 
to 47). If you operate the processor complex in 370 mode with this lOCDS, the 
processor complex would recognize the devices as 640 to 647 (channel 6, physical 
unit addresses 40 to 47). 

We recommend you specify the UNITADD parameter on the lODEVICE macro 
instruction only for an lOCDS that will be used exclusively for 370-XA mode 
operation. If you plan to generate an operating system that only supports 370 
architecture, define your device numbers so that they follow 370 restrictions: 

• The leftmost digit corresponds to a channel address. 

• The two rightmost digits correspond to the physical unit address by which 
the control unit recognizes the device. 

For more information, see the description of the UNITADD parameter on the 
lODEVICE macro instruction in this chapter. 

MODEL = model 

specifies the model number, if any, for the device. You specify one or two 
alphanumeric characters that represent the model number of the device. lOCP 
only checks the syntax for alphanumeric characters. lOCP does not vahdate the 
model value. 

For a system on which you generate VM/SP or VM/SP HPO: The 

MODEL = model parameter on the lODEVICE macro instruction in the lOCP 
input file has the same value as the MODEL = model parameter on the 
RDEVICE macro instruction in the DMKRIO file. 
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For example, the following RDEVICE macro instruction is in the DMKRIO 
file: 



RDEVICE ...,M0DEL=3 



The corresponding lODEVICE macro instruction is: 



lODEVICE ...,M0DEL=3,.. 



For a system on which you generate the VM/XA Systems Facility: The 
MODEL = model parameter on the lODEVICE macro instruction in the lOCP 
input file has the same value as the MODEL = model parameter on the 
RDEVICE macro instruction in the HCPRIO file. 

For example, the following RDEVICE macro instruction is in the HCPRIO file: 



RDEVICE ...,M0DEL=11 
The corresponding lODEVICE macro instruction is: 

r 

lODEVICE ...,M0DEL=11,... 



PATH = chpid 

specifies the preferred channel path. You specify two hexadecimal digits that 
must correspond to a channel path identifier of an attaching channel path. 

In 370-XA mode, the channel subsystem always attempts to use the preferred 
channel path to initiate I/O requests. The channel subsystem will attempt to 
initiate all I/O requests for the desired device using the specified preferred 
channel path first, before it attempts to initiate requests on any of the other 
attaching channel paths. When operating in 370 mode, the processor complex 
ignores the preferred channel path. See "Preferred Path" in Chapter 1 for more 
information. 
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TIMEOUT = 

specifies whether the eight-second I/O interface timeout function is to be active 
for the I/O interface tag sequences between the channel and I/O device. 

X 

specifies that the I/O interface timeout function is to be active for all 
sequences on the I/O interface except as noted in Appendix C. With the 
timeout function active, if the I/O device fails to complete a tag sequence 
within eight seconds or a delay occurs in a dependent tag sequence that 
exceeds eight seconds, the channel terminates the I/O request to the I/O 
device and generates an interface-control-check interruption. 



N 



TIMEOUT - Y is the default if you do not code the TIMEOUT parameter. 

specifies that the I/O interface timeout function is inactive (timeout 
inhibited) for some of the sequences on the I/O interface as described in 
Appendix C. With the timeout function inactive, the channel waits until the 
I/O device completes the tag sequence or initiates the next dependent 
sequence. 

TIMEOUT = N is not vahd for I/O devices assigned to byte multiplexer 
channel paths. 

We recommend that you specify or use the default TIMEOUT = Y for all IBM 
I/O devices. However, for certain I/O devices, normal I/O sequences sometimes 
require more than eight seconds to complete. For example, some I/O sequences 
on a channel-to-channel (CTC) adapter might require more than eight seconds 
to complete. For these devices, you may chose to specify TIMEOUT = N. 

See Appendix C for additional information about the timeout function. 

Note: When operating in 370 mode, the TIMEOUT specification for the lowest 
device address on a shared control unit (SHARED = Y or SHARED = YB) 
overrides the timeout specification of the other devices connected to the same 
control unit. For example, device lAO connects to a shared control unit and has 
TIMEOUT = Y; device lAl connects to the same control unit and has 
TIMEOUT = N. In 370 mode, both devices are timed. In 3 70-X A mode, device 
lAO is timed; device lAl is not timed. 

UNIT = device 

specifies the device type. You specify up to five alphanumeric characters to 
define the device type (such as, 3330 or 2540 R). lOCP only checks the syntax 
for alphanumeric characters. lOCP does not validate the device value. 
However, for certain device types (such as 3350P), lOCP takes special actions. 
See Appendix D for more information. 

For a system on which you generate VM/SP or VM/SP HPO: The 

UNIT = device parameter on the lODEVICE macro instruction in the lOCP 
input file has the same value as the DEVTYPE = type parameter on the 
RDEVICE macro instruction in the DMKRIO file. 
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For example, assume the following RDEVICE macro instruction is in the 
DMKRIO file: 



RDEVICE ...,DEVTYPE=3279,.. 



The corresponding lODEVICE macro instruction is: 



lODEVICE 



,UNIT=3279,.. 



For a system on which you generate the VM/XA Systems Facility: The 

UNIT = device parameter on the lODEVICE macro instruction in the lOCP 
input file has the same value as the DEVTYPE = type parameter on the 
RDEVICE macro instruction in the HCPRIO file. 

For example, assume the following RDEVICE macro instruction is in the 
HCPRIO file: 



RDEVICE ...,DEVTYPE=2540P,... 



The corresponding lODEVICE macro instruction is: 



lODEVICE ...,UNIT=2540P, 



UNITADD = address 

specifies the unit address transmitted on the channel path to select the I/O 
device. You specify two hexadecimal digits in the range of 00 through FF. 
These two hexadecimal digits must match one of the unit addresses specified on 
the UNITADD parameter of the CNTLUNIT macro instruction that defines the 
control units to which the device is assigned. 

UNITADD allows you to assign a device number in the ADDRESS parameter 
that does not contain the actual physical unit address of the device; this might 
be necessary because channel numbers may only have one hexadecimal digit and 
device numbers must be unique. The UNITADD parameter that you specify 
becomes the unit address that the control unit recognizes for the device in both 
370 mode and 370-XA mode. 
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Specify the UNITADD parameter only for an lOCDS that will be used 
exclusively for 370-XA mode operation. Operational and serviceability problems 
are Ukely to occur if you use the lOCDS (defined with UNITADD) in 370 
mode. 

If you specified a value for number in the ADDRESS parameter, that same 
number of sequential device numbers apphes to the UNITADD parameter. 
However, the UNITADD parameter plus the number of device numbers (or 
device addresses) must not exceed a hexadecimal value of FF. 

Notes: 

1. If you use the UNITADD parameter, you must follow the same rules and 
restrictions that apply to the second and third digits of the ADDRESS 
parameter. For example, notes in Appendix D that apply to the unit 
address specified on the ADDRESS keyword also apply to the unit address 
specified on the UNITADD parameter. 

2. If you specify the UNITADD parameter and use the lOCDS for 370 mode 
operation, the two digits specified in the UNITADD parameter replace the 
two rightmost digits of the device address. UNITADD changes the device 
address and makes it different from the device number. For example, 
ADDRESS = 180,UNrrADD = 90 produces a device address (370 mode) of 
190 (if the device connects to a channel path defined for 370 mode as 
channel 1). However, the device number (370-XA mode) is still 180. Thus, 
messages and error records for the same device will be issued using different 
device identifiers, 190 in 370 mode and ISO in 370-XA mode. It is also 
possible that messages and error records for a device identifier (a device 
address or device number) could actually represent more than one device. 

For a system on which you generate VM/SP or VM/SP HPO: We recommend that 
you specify the UNITADD parameter only for an lOCDS that you use exclusively 
for 370-XA mode operation. If you operate the processor complex in 370 mode and 
the active lOCDS has devices defined with the UNITADD parameter, operational 
and serviceability problems are likely to occur. 

For a system on which you generate the VM/XA Systems Facility: To code the 
UNITADD parameter, you must know how the control unit recognizes the device, 
that is by what unit address. You must code the actual physical unit address for the 
UNITADD parameter on the lODEVICE macro instruction. 

For example, the RDEVICE macro instruction for a group of eight 3330 magnetic 
disks could be: 



RDEVICE DEVN0=(350,8) ,DEVTYPE=3330, . . . . 



The device nimibers for these disks range from 350 to 357. The control unit, 
however, recognizes the disks as being attached at unit addresses 40 through 47. 
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The UNITADD parameter on the lODEVICE macro instruction should be 40: 



lODEVICE ADDRESS=(350,8) ,. . . .UNIT=3330,UNITADD=40 



(The UNITADD parameter on the lODEVICE macro instruction takes the same 
number (8) as specified in the ADDRESS parameter.) 

Note: This example uses the UNITADD parameter to define device numbers (350 
to 357) that do not contain their physical unit addresses (40 to 47). If you were to 
operate the processor complex in 370 mode with this lOCDS, the processor complex 
would recognize the devices as 340 to 347 (channel 3, physical unit address 40 to 47). 

We recommend, however, that if you specify the UNITADD parameter on an 
lODEVICE macro instruction, you operate the processor complex with that lOCDS 
only in 370-XA mode. If you plan to generate an operating system that only 
supports 370 architecture, define your device numbers so that they follow 370 
restrictions: 

• The leftmost digit corresponds to a channel address. 

• The two rightmost digits correspond to the unit address by which the control 
unit recognizes the device. 

Example: The following macro instruction defines a 2540 Card Read Punch Model 
1 with an address of OOD. It attaches to a 2821 Control Unit that has a control unit 
number of 10 A. 



DEVOOD 


lODEVICE 


ADDRESS = OOD,CUNUMBR= 10A,MODEL= 1, 
UNIT = 2540P,TIMEOUT = Y 



Example: The following macro instrucfion defines eight 3330 Disk Storage Model 1 
devices. The 3830 Storage Control has a control unit number UB and recognizes 
the device addresses/numbers of 210 through 217. 



DEV2DD 


lODEVICE 


ADDRESS -(210,8),CUNUMBR-1 IB, 
MODEL = 1 ,UNIT = 3330,TIMEOUT = Y 



Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has the control unit number OOE and recognizes the device 
addresses/numbers of D80 through D87. 



DEVDTT 


lODEVICE 


ADDRESS = (D80,8),CUNUMBR = OOE, 
MODEL = 3, UNIT = 3420,TIMEOUT = Y 
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Example: The following macro instruction defines eight 3420 Magnetic Tape Units 
attached to two 3803 Tape Controls via the tape switching feature. The control 
units are assigned the numbers 01 B and OIC. Both control units recognize the unit 
addresses of 40 through 47. (Note: In this case the control units must attach to 
different channel paths to ensure that unit addresses are not duplicated on the same 
channel path.) C is the channel number that corresponds to the lower numbered 
channel path assigned to the device. 



DEVTUU 


lODEVICE 


ADDRESS = (C40,8),CUNUMBR = (0 1 B,0 1 C), 
MODEL = 3,UNIT = 3420,TIMEOUT = Y 



Example: The following macro instruction defines two 3350 I/O devices for use as 
paging devices by the 3880 Model 1 1 Paging Storage Subsystem. The 3880 Model 
11 Paging Storage Director has been assigned control unit number 14B. 

lOCP generates four device addresses/numbers for each 3 3 SOP (a 3350 used as a 
paging device by the 3880 Model 11): the base address as specified on the 
ADDRESS parameter, and three additional addresses at intervals of eight. 

This macro instruction causes lOCP to generate addresses 440, 448, 450, and 458 for 
base address 440, and addresses 441, 449, 451, and 459 for base address 441. 



DEV4DD 


lODEVICE 


ADDRESS = (440,2),CUNUMBR- 14B, 
UNIT = 3350P,TIMEOUT = Y 



Example: The following macro instruction defines eight 3420 Magnetic Tape Units. 
The 3803 Tape Control has been assigned the control unit number 530. The device 
numbers (for 370-XA mode) are 180 through 187. But the devices respond to the 
unit addresses of 90 through 97 (not 80 through 87) in both 370-XA mode and 370 
mode. Thus, the device addresses (for 370 mode) are actually 190 through 197. 



DEVIUA 


lODEVICE 


ADDRESS = (180,8),CUNUMBR = 530, 
MODEL = 3,UNIT = 3420,UNITADD = 90 
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lOCP Functions 

You invoke the VM version of lOCP in tlie CMS environment. Issue the CMS 
lOCP command to execute lOCP under VM/SP, VM/SP HPO or the VM/XA 
Systems Facility. The lOCP command has options that allow you to request the 
following lOCP functions: 

• Generate a new lOCDS from a file containing source lOCP macro instructions 

• Produce configuration reports from an existing lOCDS.' 

Generating an lOCDS 

lOCP performs the following steps when you specify that you want to generate an 
lOCDS. 

Note: lOCP repeats steps 1 through 5 for each input macro instruction read (unless 
lOCP finds an error as indicated in Steps 3 and 4). 

lOCP: 

1. Reads each macro instruction from the input device. 

2. Prints each macro instruction on the output printer. 

3. Checks the syntax of each macro instruction for correct format. If it finds a 
syntax error (such as a missing parenthesis), lOCP prints an error message on 
the output printer following the macro instruction that contains the error. lOCP 
stops checking the syntax of a macro instruction when it encounters the first 
syntax error on that macro instruction. Therefore, if there are two or more 
syntax errors on a single macro instruction, lOCP finds the second and following 
errors on subsequent runs. 

If lOCP finds an error in Step 3, lOCP returns to Step 1 and continues reading, 
printing, and checking the syntax of the remaining macro instructions, but does 
not perform any of the following steps. 

4. Checks the validity of each macro instruction. For example, lOCP checks that a 
CNTLUNIT macro instruction has specified a channel path previously defined 
on a CHPID macro instruction. If it finds an error, lOCP prints an error 
message on the output printer following the macro instruction that contains the 
error. 

If lOCP finds an error in Step 4, lOCP returns to Step 1 and performs only 
Steps 1 through 3 for the remainder of the macro instructions. Therefore, if 
there are two or more validity errors in your input file, lOCP finds the second 
and following errors on subsequent runs. 

5. Builds the appropriate identification, channel path, control unit, or I/O device 
record and enters the record into the lOCDS in storage. 

If more macro instructions remain to be read, lOCP returns to Step 1 . 



1 The CMS lOCP module DMSICP generates DIAGNOSE X'80' when you use the lOCP command to read from or 
to write to an lOCDS. The Control Program (CP) uses DIAGNOSE X'80' to communicate with the processor 
controller. For a description of DIAGNOSE X'80', see VM/SP System Programmer's Guide, VM/SP HPO System 
Programmer's Guide, or VM/XA Systems Facility CP Programming Services. 
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After processing all of the input macro instructions and entering all of the records 
into the lOCDS in storage, lOCP performs Step 6. 

6. Generates the lOCDS in storage and makes additional checks. For example, 
lOCP checks that the channel numbers within a channel set are consecutive. If 
lOCP finds an error, lOCP issues an error message and then terminates. 

After lOCP has successfully generated an lOCDS in storage, lOCP performs Step 7. 

7. Produces the lOCP configuration reports of the lOCDS generated in storage. 

If you specify a generation option of the lOCP command other than NOWRTCDS 
and you are authorized to do so, lOCP performs Step 8. 

8. Writes the generated lOCDS from storage to one or more lOCDS(s) in the 
processor controller. The Control Program (CP) checks your privilege class. If 
you are running lOCP under the VM/SP or VM/SP HPO, you must have 
privilege class C to write to the lOCDS in the processor controller. If you are 
running lOCP under the VM/XA Systems Facility, you must have privilege 
classes C, F, and G to write to the lOCDS in the processor controller. 

Producing Configuration Reports 

lOCP performs the following steps when you request configuration reports. 

lOCP: 

• Reads one or more lOCDS(s) from the processor controller into storage. 

• Prints the lOCP configuration reports that you specify. 

If lOCP encounters any errors during processing, lOCP sends appropriate error 
messages to the output printer. For examples of lOCP configuration reports, see 
"Chapter 5. lOCP Configuration Reports". 
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The lOCP Command 

The format of the lOCP command is: 



lOCP 



[fn] [(opi 


:ions . 




. . [)]] 




Processor Option 


!•• 


" 308X ' 




XXXX J 




lOCDS Generation options: 




[noignore 1 


NOWRTCDS 




IGNORE J 


WRTCDS 
WRTAx 
WRTBx 
WRTABx 




Configuration Report options 


BOTHRPT 




CDORPT 




CDIRPT 




RPTAx 




RPTBx 




RPTA 




RPTB 




RPTAB _ 




Listing Control options: 




[LINECOUN (55) 1 




'disk "^ 




LINECOUN (nn) 




PRINT 




' 


NOPRINT 




System Terminal options: 




[TERMINAL ] [WARNING ] 




NOTERM 




NOl 


^A 


RN 







where: 

fn is the filename of the input or output file, depending on options you specify on 
the command line. 

You must specify a filename only when input is from disk or output is to disk. 

When you specify lOGDS generation options, fn is: 

• The filename of the input file. The input file contains the lOCP macro 
instructions. 

• The filename of the output file. If lOCP finds no errors, the output file will 
contain the configuration reports of the lOCDS lOCP generate from your 
input as well as a hsting of your input. If lOCP does find errors, the output 
file will contain only a listing of the input file and any errors that lOCP 
finds. 



3-32 IOC? User's Guide and Reference 



When you specify configuration report options, fn is: 

• The filename of the output file. The output file will contain the 

configuration reports of the lOCDS(s) you request from the processor 
controller. 

lOCP issues, by default, the following CMS FILEDEF commands for the 
SYSIN (input to lOCP) and SYSPRINT (output from lOCP) ddnames: 

FILEDEF SYSIN DISK fn lOCP * (RECFM FB LRECL 80 
BLOCK 800 

FILEDEF SYSPRINT DISK fn LISTING fm (RECFM FBA 
LRECL 133 BLOCK 1330 

lOCP obtains fn from the filename entered on the lOCP command. 

lOCP obtains fm by checking the disk that contains the input file. If the disk is 
read/write, lOCP writes back to the same disk. However, if the disk is an 
extension to a disk, lOCP writes to the parent disk. If neither of these is true, 
lOCP writes to the A-disk (provided it is read/write). 

Because the default FILEDEF commands specify DISK, you must use a 
filename on the lOCP command unless you override those default FILEDEF 
commands. If you want to override a default FILEDEF command, issue your 
own FILEDEF command before executing lOCP. Note that if you specify 
PRINT or NOPRINT on the lOCP command, you will automatically override 
SYSPRINT FILEDEF. 

The input filetype is, by default, lOCP. If you want the the input file to have a 
filetype other than lOCP, issue a FILEDEF command to override the default 
filetype. 

The output filetype is, by default, LISTING. If you want the the output file to 
have a filetype other than LISTING, issue a FILEDEF command to override 
the default filetype. 

Options: 

lOCDS Generation Options: 

The valid options for writing an lOCDS depend on the number of I/O configuration 
data sets that your processor complex supports: 

• For two I/O configuration data sets (LVLO and LVLl), the valid options are 
NOWRTCDS, WRTCDS, and WRTAl. (WRTAl is the same as WRTCDS.) 

• For four I/O configuration data sets, the valid options on the A side are 
NOWRTCDS, WRTCDS, and WRTAx. The vaUd options on the B side are 
NOWRTCDS, WRTCDS, and WRTBx. 

• For eight I/O configuration data sets, all of the options are valid. 

lOCP writes an lOCDS to the processor controller (in response to all the generation 
options except NOWRTCDS) only if: 

• It finds no errors on the input macro instructions 

• It encounters no errors during lOCP processing of the lOCDS in storage 

• The user issuing the lOCP command has the proper privilege class 

• You did not write-protect the lOCDS (on the lOCDSM frame) 
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Use a write option (WRTCDS, WRTAx, or WRTBx) after you have (1) checked the 
syntax of the input macro instructions, (2) generated an lOCDS in storage, (3) 
received reports on the generated lOCDS, and (4) checked to see whether or not the 
I/O configuration generated by lOCP corresponds to the I/O configuration in the 
DMKRIO file (for VM/SP or VM/SP HPO) or in the HCPRIO file (for the VM/XA 
Systems Facility). If you want to write to an lOCDS that is write-protected, you 
must also remove the write-pro tecti on using the lOCDSM (SYS021) frame. 

When lOCP writes the generated lOCDS to an lOCDS in the processor controller, 
the previous configuration data in that lOCDS is overlaid and lost, even if that 
lOCDS is the active lOCDS. (The lOCDS used for the last power-on reset or 
SYSIML CLEAR is the active lOCDS). 

NOIGNORE 
NOIGN 

specifies that lOCP is to process all input macro instructions and parameters. 
lOCP flags as errors any non-IOCP input data. If lOCP finds an error, it does 
not generate an lOCDS in storage. 

Use the NOIGNORE option when your deck contains only lOCP macro 
instructions and lOCP comment cards. This option is a default. 

IGNORE 
IGN 

specifies that lOCP is to ignore all non-IOCP macro instructions and non-IOCP 
parameters on the lODEVICE macro instruction. 

NOWRTCDS 
NOWRT 

specifies that lOCP is not to write the lOCDS that is in storage to an lOCDS in 
the processor controller. This option is a default. 

Use the NOWRTCDS option when (1) you are checking the syntax of the input 
file and do not want to write to the processor controller until you have 
successfully checked the input file, or (2) when you are operating on a processor 
complex not listed on the cover of this manual. 

When you specify the NOWRTCDS option and lOCP finds no errors, the 
output file will contain the configuration reports of the lOCDS lOCP will be 
generate from your input along with a hsdng of your input file. If lOCP finds 
errors, your output file will contain only a listing of your input file and any 
errors that lOCP finds. 

WRTCDS 
WRT 

specifies that lOCP is to write the lOCDS that is in storage to the Al lOCDS 
(LVLl lOCDS) in the processor controller. 

WRTAx 
WAx 

specifies that lOCP is to write the lOCDS that is in storage to the level Ax 
(where x is 0, 1, 2 or 3) lOCDS in the processor controller. 

WRTBx 
WBx 

specifies that lOCP is to write the lOCDS that is in storage to the level Bx 
(where x is 0, 1,2, or 3) lOCDS in the processor controller. (WRTBx is vahd 
only on the B side of a processor complex.) 
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WRTABx 
WABx 

specifies that lOCP is to write the lOCDS (where x is 0, 1, 2 or 3) in storage to 
the level x lOCDS in the processor controller on both the A side and the B side. 

This option is only valid if the system is NOT generated in partitioned mode. 

Configuration Report Options 

The valid options for reading an lOCDS and producing configuration reports 
depend on the number of I/O configuration data sets that your processor complex 
supports: 

• For two I/O configuration data sets (LVLO and LVLl), the vahd options are 
BOTHRPT, CDORPT, CDIRPT, RPTAO, and RPTAl. 

• For four I/O configuration data sets, all of the configuration report options are 
vahd on the A side except RPTBx and RPTB. On the B side, all of the 
configuration report options are valid except RPTAx and RPTA. 

• For eight I/O configuration data sets, all of the options are valid. 

BOTHRPT 
BOTH 

specifies that lOCP is to read both the AO and Al lOCDS from the processor 
controller into storage and is to generate configuration reports of both data sets. 

CDORPT 
CDO 

specifies that lOCP is to read the AO lOCDS from the processor controller into 
storage and is to generate a configuration report of that data set. 

CDIRPT 
CDl 

specifies that lOCP is to read the Al lOCDS from the processor controller into 
storage and is to generate a configuration report of that data set. 

RPTAx 
RAx 

specifies that lOCP is to read the level Ax (where x is 0, 1, 2, or 3) lOCDS from 
the processor controller into storage and is to generate a configuration report of 
that data set. (RPTAx is valid only on the A side of a processor complex.) 

RPTBx 
RBx 

specifies that lOCP is to read the level Bx (where x is 0, 1,2, or 3) lOCDS from 
the processor controller into storage and is to generate a configuration report of 
that data set. (RPTBx is valid only on the B side of a processor complex.) 

RPTA 
RA 

specifies that lOCP is to read the entire A side (the AO, Al, A2, and A3 lOCDS) 
from the processor controller into storage and is to generate configuration 
reports of those data sets. (RPTA is valid only on the A side of a processor 
complex.) 
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RPTB 
RB 

specifies that lOCP is to read the entire B side (the BO, Bl, B2, and B3 lOCDS) 
from the processor controller into storage and is to generate configuration 
reports of those data sets. (RPTB is valid only on the B side of a processor 
complex.) 

RPTAB 
RAB 

specifies that lOCP is to read the entire A side (the AO, Al, A2 and A3 lOCDS) 
and the entire B side (the BO, Bl, B2 and B3 lOCDS) from the processor 
controller into storage and is to generate configuration reports of those data 
sets. 

This option is only valid if the system is NOT generated in partitioned mode. 

Listing Control Options: 

LINECOUN (55) 
LINECOUN (nn) 

specifies the number of lines (from 10 to 99) that is to be printed on each page. 
The default is LINECOUN (55). If you use this option, note that you must 
specify the number of lines. 

DISK 

specifies that lOCP is to place the output hsting in a file on a minidisk. DISK is 
a default option. 

PRINT 
PR 

specifies that lOCP is to send the output Hsting to the printer. 

NOPRINT 
NOPR 

specifies that lOCP is not to generate any output listing. 

System Terminal Options: 

TERMINAL 
TERM 

specifies that lOCP is to write diagnostic information from the lOCP program to 
your terminal. TERMINAL is a default option. Diagnostic information 
consists of either of the following: 

• An lOCP message (see "Chapter 6. lOCP Messages") and, preceding this 
message, the nonblank line that caused the diagnostic message 

• A display of the total message count for the lOCP output 

NOTERM 

specifies that lOCP is to suppress display of diagnostic messages at your 
terminal. 

WARNING 
WARN 

specifies that lOCP is to write lOCP warning messages to the terminal. This 
option is vahd only if you specify the TERMINAL option. WARNING is a 
default option. 
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NOWARN 

specifies that lOCP is to suppress the writing of warning messages at your 
terminal. 

Processor Options: 

Select the appropriate processor option to perform an lOCDS generation. The 
lOCDS must be generated on the same processor complex that is designated by the 
selected processor option. 

Select the appropriate processor option to perform syntax checking of input lOCP 
macro instructions on another processor complex. Syntax checking can be 
performed when the required processor complex is not available. 

Errors will occur if the WRTCDS, WRTAx, WRTBx, or any of the Configuration 
Report options are selected and the processor option that is specified does not match 
the identification of the processor to which the lOCP command is given; errors will 
occur when an attempt is made to read or write an lOCDS if the processor option 
does not match the processor you are running on. 

The valid processor options are: 

308X 

The 308X option specifies that lOCP is to process the command options and 
input file for an lOCDS generation for a processor complex in the 308X series 
or the 908X series. This option is the default if the lOCP command is given, 
without specifying a processor option, to a 308X or 908X processor complex or 
any processor complex that does not support lOCP. 

xxxx 

xxxx is a four digit number associated with a non-308X processor family 
complex that is supported by lOCP. The xxxx option specifies that lOCP is to 
process the command options and input file for an lOCDS generation for a 
processor complex that is supported by lOCP and is not a 308X or 908X. If the 
lOCP command is given without specifying a processor option on any processor 
complex supported by lOCP, this option will default to the current processor 
ID. 

See the lOCP User's Guide that is associated with the processor complex for 
which the verification and/or generation is being run. 

Restrictions: 

1. You cannot issue the lOCP command while in the CMS/DOS environment. 

2. If VM/SP or VM/SP HPO Release 1 is running with single processor mode 
active, do not issue the lOCP command with any write options (WRTCDS, 
WRTAx, or WRTBx) or with any configuration report option (BOTHRPT, 
CDORPT, CDIRPT, RPTAx, RPTBx, RPTA, or RPTB). If single processor 
mode is active and you issue the lOCP command: 

• From a virtual machine operating in the V = R area, results are 
unpredictable. 
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• From a virtual machine operating in the V = V area, lOCP issues the 
following messages: 



ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 
CODE OF 01F0 HEX 

ICP051I lOCP TERMINATED. CODE=xx 



lOCP sends a return code 8 to CMS. 

To execute lOCP when single processor mode is active, follow the steps in "Method 
2" under "Subsequent Definition and Replacement of I/O Configuration Data" in 
this chapter. 

Note: Restriction 2 does not apply to VM/SP HPO Release 2 and subsequent 
releases. If VM/SP HPO (Release 2 or later) is operating in single processor mode, 
and any virtual machine (CMS or MVS/SP) causes lOCP to read from or write to 
the processor controller, CP locates and stops (SIGP STOP) the processor dedicated 
to the virtual = real virtual machine. Then CP executes the read or write function. 
When the service signal external interruption occurs, CP restarts the dedicated 
processor. 
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lOCP Command General Usage Notes 



This section lists some general notes to keep in mind when you issue the lOCP 
command. Some aspects of using the command, vary with the operating system on 
which you run lOCP. For usage notes specific to your operating system, see the 
sections immediately following. 

1. Some lOCP command options cancel other lOCP command options. For this 
reason, when you code the lOCP command, do not combine lOCDS generation 
options with configuration report options. (lOCP allows multiple configuration 
report options.) 

If you inadvertently code conflicting options on the same lOCP command, lOCP 
will use the last-entered of those conflicting options. lOCP issues no warning 
message. 

2. If the lOCDS you wish to write to is write-protected, the write options 
(WRTCDS, WRTAx, and WRTBx) are invalid. (To add or remove the write 
protection for an lOCDS, use the lOCDSM frame.) 

3. The TERMINAL and WARNING options are not active if you issue your own 
CMS FILEDEF SYSPRINT command. 
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lOCP Command Usage Notes for VM/SP and VM/SP HPO 

1. If you are running lOCP under VM/SP or VM/SP HPO, CP checks your 
privilege class when lOCP issues a DIAGNOSE X'80' to read from or write to 
an lOCDS. You must have privilege class E or C to read from an lOCDS; you 
must have privilege class C to write to an lOCDS. If you attempt to read from 
an lOCDS and if you are not a class C or E user, you receive the message 



ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 
CODE OF OlFO HEX 



lOCP prints the message and the response code on the SYSPRINT device. 

If you are not a class C user and you attempt to write to the lOCDS, you 
receive the message 



ICPG51I lOCP TERMINATED. C0DE=09 



and lOCP processing stops. 

If you attempt to update an lOCDS while running on a processor complex that 
does not support lOCP, and do not specify a processor option, you receive the 
following message on the SYSPRINT device and lOCP processing stops. 



ICP400I READ/WRITE OF lOCDS IS INVALID ON THIS 

PROCESSOR 
ICP051I lOCP TERMINATED. CODE =10 



The messages are printed on the SYSPRINT device. lOCP then stops processing. 

If you request a configuration report while running on a processor complex that 
does not support lOCP, you receive the same message, ICP400I, printed on the 
SYSPRINT device. 

If you attempt to update an lOCDS or request a configuration report for an 
lOCDS while running on a processor complex that supports lOCP and is not a 
308X or 908X and the 308X processor option was specified, you receive an error 
message. If you attempt to update an lOCDS or request a configuration report 
for an lOGDS while running on a 308X or 908X processor complex and any 
other processor option was specified, you receive an error message. 



ICP40OI READ/WRITE OF lOCDS IS INVALID ON THIS 

PROCESSOR 
ICP051I lOCP TERMINATED. CODE =10 



The messages are printed on the SYSPRINT device. lOCP then stops processing. 

4. If you and another user attempt to read the same lOCDS at the same time, you 
will receive the following message: 



ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 
CODE OF 41 F0 HEX 



Wait several minutes and again attempt to read that lOCDS by issuing another 
lOCP command. 
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5. You must define your I/O configuration for the processor complex using lOCP 
macro instructions; define that same configuration for VM/SP or VM/SP HPO 
in the DMKRIO file. 

6. If you are attempting to write an lOCDS to the processor controller and either 
the lOCP program abnormally terminates, or you issue the CMS command 
HALT EXECUTION (HX) while lOCP is running, you may prevent another 
authorized user from writing the same lOCDS to the processor controller. Under 
these circumstances the system may have locked the lOCDS for you. The other 
user will receive the following messages: 



ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 
CODE OF 41F0 HEX 



ICP051I lOCP TERMINATED. 



CODE =xx 



where xx is a code that indicates lOCP encountered an error while trying to 
write the lOCDS locked for you. 

The other user will receive these messages each time he tries to write the locked 
lOCDS until you do one of the following: 

• Rerun the lOCP program to completion, successfully writing the locked 
lOCDS to the processor controller. 

• Issue a SYSTEM RESET command to reset your virtual machine. 

• Issue a LOGOFF command to log off your virtual machine. 

The other user will then be able to write the lOCDS that the CP previously 
locked for you. 



lOCP Command Usage Notes for the VM/XA Systems Facility 

1 . If you are running lOCP under the VM/XA Systems Facility, CP checks your 
privilege class when lOCP issues a DIAGNOSE X'80' to read from or write to 
an lOCDS. To read from an lOCDS you must have privilege classes F, G, and 
either E or C; to write to an lOCDS you must have privilege classes C, F, and 
G. 

If you attempt to read from an lOCDS and you do not have the required 
privilege classes, you receive the following messages: 



ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 

CODE OF 42F0 HEX 
ICP051I lOCP TERMINATED. CODE=xx 



where xx is a code that indicates the lOCDS you were trying to read. The 
messages are printed on the SYSPRINT device. lOCP then stops processing. 

If you attempt to write to an lOCDS and you do not have the required privilege 
classes, you receive the following messages: 



ICP402I MSSFCALL RETURNED Al 

CODE OF 42F0 HEX 
ICP051I lOCP TERMINATED. CODE=xx 



EXPECTED RESPONSE 



where xx is a code that indicates the lOCDS you were trying to write. The 
messages are printed on the SYSPRINT device. lOCP then stops processing. 
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If you attempt to update an lOCDS while running on a processor complex that 
does not support lOCP, and do not specify a processor option, you receive the 
following message on the SYSPRINT device and lOCP processing stops. 



ICP40OI READ/WRITE OF lOCDS IS INVALID ON THIS 

PROCESSOR 
ICP051I lOCP TERMINATED. CODE= 10 



If you request a configuration report while running on a processor complex that 
does not support lOCP, you receive the same messages, ICP400I and ICP051I, 
printed on the SYSPRINT device. 

If you attempt to update an lOCDS or request a configuration report for an 
lOCDS while running on a processor complex that supports lOCP and is not a 
308X or 908X and the 308X processor option was specified, you receive an error 
message. 



ICP400I READ/WRITE OF lOCDS IS INVALID ON THIS 

PROCESSOR 
ICP051I lOCP TERMINATED. CODE= 10 



If you request a configuration report while running on a processor complex that 
does not support lOCP, you receive the same messages, ICP400I and ICP051I, 
printed on the SYSPRINT device. 

If you attempt to update an lOCDS or request a configuration report for an 
lOCDS while running on a 308X or 908X processor complex and any other 
processor option was specified, you receive an error message. 

4. If you and another user attempt to read the same lOCDS at the same time, you 
will receive the following message at your terminal: 



HCPPCA837I lOCP READ SEQUENCE REJECTED, LOCKED BY 
userid 



where userid is the userid of the other user. This will be followed by: 



ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 

CODE OF OlFO HEX 
ICP051I lOCP TERMINATED. CODE=xx 



where xx is a code that indicates which lOCDS you were trying to read. Wait 
several minutes and again attempt to read that lOCDS by issuing another lOCP 
command. 

5. You must define your I/O configuration for the processor complex using lOCP 
macro instructions; define that same configuradon for VM/XA Systems Facihty 
in the HCPRIO file. 

6. If you are running lOCP and it does not complete successfully, you may prevent 
another authorized user from running lOCP. You may be attempting to either 
read or write an lOCDS. lOCP may fail to complete successfully either because 
it abnormally terminates or because you issue the CMS command HALT 
EXECUTION (HX) while lOCP is running. Under these circumstances, CP may 
lock all lOCDS(s) for you while trying to access one of them. 
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The other user will receive a number of messages. If the other user tries to write 
to an lOCDS, the user will receive the following message: 

HCPPCA836I lOCP WRITE SEQUENCE REJECTED, LOCKED BY 
yourid 

where yourid is your userid. 

If the other user tries to read an lOCDS, the user will receive: 



HCPPCA837I lOCP READ SEQUENCE REJECTED, LOCKED BY 

yourid 

\ 

where yourid is the userid of the other user. 

In either case, the other user will receive the following additional messages: 

ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE 

CODE OF 01FO HEX 
ICP051I lOCP TERMINATED. CODE=xx 

where xx is a code that indicates the lOCDS the user was trying to access and 
whether the user was trying to read or write. 

The other user will receive these messages each time he tries to run lOCP until 
you do one of the following: 

• Rerun the lOCP program to completion. lOCP must complete the same 
operation that was interrupted (read or write) for the same lOCDS. 

• Issue a SYSTEM RESET command to reset your virtual machine. 

• Issue a LOGOFF command to log off your virtual machine. 
The other user will then be able to access any of the lOCDS(s). 

Examples of Generating an lOCDS 

Example 1: This example shows the IOC? command options you use to check an 
input file containing only lOCP macro instructions. lOCP displays any warning or 
error messages at your terminal. The output file MIFILE LISTING will contain the 
configuration reports for the configuration described by the input file MIFILE 
lOCP. 



lOCP MIFILE (NOIGNORE NOWRTCDS LINECOUN (60) 



where: 

MIFILE 

is the name of the CMS file (filetype lOCP) that contains only lOCP macro 
instructions. 

NOIGNORE 

specifies that lOCP is to flag as errors all data that are not lOCP macro 
instructions. 



Chapter 3. Executing the VM Version of lOCP 3-43 



NOWRTCDS 

specifies that lOCP is not to write the lOCDS generated in storage to an lOCDS 
in the processor controller. 

LINECOUN (60) 

specifies that lOCP is to print 60 lines of output on each page of the 
configuration reports. 

Example 2: This example shows the lOCP command options you use to: 

• Process an input file containing only lOCP macro instructions 

• Generate an lOCDS in storage 

• Write the generated lOCDS to the level AO lOCDS in the processor controller 

The output file NEWIOCDS LISTING will contain a listing of the input in 
NEWIOCDS lOCP and configuration reports of the generated lOCDS. 



lOCP NEWIOCDS (WRTA0 



where: 

NEWIOCDS 

is the name of the CMS file that contains only lOCP macro instructions. 

WRTAO 

specifies that lOCP is to write the lOCDS generated in storage to the level AO 
lOCDS in the processor controller. 

Examples of Producing a Configuration Report 

Example 1: This example shows the lOCP command opdons you use to produce a 
report of every lOCDS on the A side of the processor complex. These reports allow 
you to analyze your installation's present I/O configuration. 



r 



lOCP lOCDSRPT (RPTA LINECOUN (65) DISK NOTERM 

where: 

lOCDSRPT 

is the filename of the output file that will contain the configuration reports. 
Note that the filetype will be LISTING. 

RPTA 

specifies that lOCP is to create a Usting of every lOCDS on the A side (the AO, 
Al, A2, and A3 lOCDS). 

LINECOUN (65) 

specifies that lOCP is to produce a listing that contains 65 lines of output per 
page. 

DISK 

specifies that lOCP is to send its output to disk. 

NOTERM 

specifies that lOCP is not to display any diagnostic messages at the terminal. 
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Example 2: This example shows the lOCP command options you use to write a test 
configuration source file to the Al lOCDS in the processor controller. 

f lOCP PS13 (WRT IGNORE PR J 

where: 

PS13 

is the filename of the CMS file containing your input lOCP macro instructions. 
The filetype is lOCP. 

WRT 

specifies that lOCP is to write the configuration defined in PS 13 to the level Al 
lOCDS in the processor controller. 

IGNORE 

specifies that lOCP is to ignore all non-IOCP macro instructions and parameters 
contained in the PS 13 data set. 

PR 

indicates that lOCP is to send the configuration report of the PS 13 data set to 
the printer. 
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Return Codes 



When you execute the VM version of lOCP, lOCP returns one of the following 
codes at the completion of the job. 



Return Code 
Decimal 


Description/ Action 





lOCP completed the requested function without error. 


4 


lOCP completed the requested functions without error but 
issued one or more warning messages. The warning messages 
in the output Hstings or the report describe the specific 
conditions that caused the warning. 


8 


lOCP encountered an error and terminated processing before 
completing the requested function. The error message in the 
output listing describes the specific condition that caused the 
error. 


12 


lOCP terminated because the output data set DCB failed to 
open. lOCP was unable to print messages or reports. Ensure 
that the FILEDEF command for the output data set is correct. 
You may query the data definitions for all files by issuing the 
CMS FILEDEF command without operands. 


16 


lOCP terminated because it could not obtain enough storage. 
Define more virtual storage for your virtual machine, re-IPL 
CMS, and issue the lOCP command again. 



In addition to the return codes listed, the CMS-IOCP interface module, DMSICP, 
issues its own error messages with corresponding return codes for each message. For 
the return codes generated with error messages, see "lOCP Messages (DMSICP 
Prefix)" in "Chapter 6. lOCP Messages." 
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Methods of Executing the VM Version of lOCP 

This topic suggests ways that you can execute the VM version of lOCP to: (1) 
initially define and check the I/O configuration data for a new processor complex, 
and (2) subsequently redefine and replace the I/O configuration on an installed 
processor complex. 

initial Definition of I/O Configuration Data 

There are two methods you can use to initially define and vahdate the I/O 
configuration data for a new processor complex: 

• If you have time to prepare an lOCP input file on an existing system before 
installing the processor complex, use Method One. 

• If you can use the starter lOCDS shipped with the processor complex, use 
Method Two. 

Method One: 

Before installing the processor complex, you can create an lOCP input file on an 
existing system. The customer engineer (CE) uses this input file during the 
installation of the new processor complex. To prepare an input file, follow these 
steps: 

1. Determine, from your physical plan, the I/O configuration requirements that 
must be met in order to install the processor complex. 

2. Prepare an input file of lOCP macro instructions that define your I/O 
configuration and system requirements. The customer engineer will use this file 
when he installs the processor complex. For a sample input file containing 
lOCP macro instructions, see Figure B-4 in Appendix B. 

3. Check the lOCP macro instruction input by executing the lOCP command under 
CMS. Code NOWRTCDS and NOIGNORE on the lOCP command. This 
command allows you to check the syntax of the lOCP macro instructions as well 
as to check the configuration reports for the desired configuration data. 

Note: The I/O information in the DMKRIO file (for VM/SP or VM/SP HPO) 
or HCPRIO file (for the VM/XA Systems Facility) used in system generation 
should correspond to the information you code in the lOCP macro instructions. 
Figure B-5 in Appendix B contains a sample DMKRIO file that corresponds to 
the sample lOCP input file shown in Figure B-4. Figure B-6 in Appendix B 
contains a sample HCPRIO file that corresponds to the sample lOCP input file 
shown in Figure B-4. 

4. If there are any errors in the lOCP macro instructions, correct the errors and 
rerun lOCP (Step 3). 

5. Analyze the lOCP configuration reports (produced in Step 3) to ensure that the 
desired I/O configuration is defined. If necessary, revise the lOCP macro 
instructions and rerun lOCP. 

6. Create a tape or card deck of lOCP macro instructions from the input file you 
have created. 

Note: During the physical installation of the processor complex, the CE uses 
your validated input deck (with the stand-alone version of lOCP) to configure 
and test the I/O configuration for the new processor complex. An example for 
the CE is provided under "Generating an lOCDS on a New Processor Complex" 
in Chapter 4. 
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Method Two: 

The processor complex is shipped with a starter lOCDS. You can decide whether or 
not this starter lOCDS meets your I/O needs. To use the starter lOCDS, follow 
these steps: 

1. Determine the I/O devices your installation uses and whether the starter lOCDS 
defines these devices. If you will generate VM/SP or VM/SP HPO, make sure 
the addresses in the lOCDS correspond to the addresses for these devices in the 
DMKRIO file. If you will generate the VM/XA Systems Facility, make sure the 
addresses in the lOCDS correspond to the addresses for these devices in the 
HCPRIOfile. 

2. Proceed with the installation of the processor complex if the starter lOCDS 
defines enough DASD to IPL a VM/SP, VM/SP HPO, or VM/XA Systems 
Facility system. Use the lOCDS shipped with the processor complex. 

3. Reconfigure your I/O, once you initiahze VM/SP, VM/SP HPO, or the VM/XA 
Systems Facility according to the particular physical configuration of your 
installation. (See "Subsequent Definition and Replacement of I/O Configuration 
Data" in this chapter.) 

Note: If the starter lOCDS shipped with the processor complex does not correspond 
to your particular I/O configuration, your customer engineer must execute the 
stand-alone version of lOCP. (See "Chapter 4. Executing the Stand-Alone Version 
oflOCP".) 

Subsequent Definition and Replacement of I/O Configuration Data 

There are two methods you can use to replace the existing I/O configuration data on 
a processor complex: 

• If VM/SP or VM/SP HPO Release 1 is not running in single processor mode, or 
you have installed VM/SP HPO Release 2 or a subsequent release, use Method 
One. 

• If VM/SP or VM/SP HPO Release 1 is running in single processor mode, use 
Method Two. 

• If you are running the VM/XA Systems Facihty, use Method One. 

Method One: 

The following steps describe how your installation can replace the existing I/O 
configuration data on a processor complex when VM/SP or VM/SP HPO Release 1 
is not running in single processor mode. You may follow these steps for VM/SP 
HPO Release 2 and subsequent releases, regardless of the system mode. You may 
also follow these steps for the VM/XA Systems Facility: 

1 . Update the input file that contains the lOCP macro instructions to reflect your 
new I/O configuration. Figure B-4 in Appendix B contains a listing of a sample 
input file. 

2. Execute the VM version of lOCP to check the input file you updated in Step I. 
Use the NOWRTCDS option on the CMS lOCP command. 

3. Correct any errors on the lOCP macro instructions and rerun lOCP (Step 2). 

4. Analyze the lOCP configuration reports (produced in Step 2) to ensure that the 
desired I/O configuration is defined. If necessary, revise the lOCP macro 
instructions and rerun lOCP (Step 2). 
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5. Execute the lOCP program by issuing the lOCP command with a write option 
(WRTCDS, WRTAx, or WRTBx). This option writes the I/O configuration to 
the specified lOCDS in the processor controller. All users running under VM/SP 
or VM/SP HPO must have privilege class C to write. All users running under the 
VM/XA Systems FaciHty must have privilege classes C, F, and G to write. 

Note: Continue with Steps 6 through 1 1 when you wish to use the new lOCDS 
created in Step 5. Perform these steps at a convenient time, because these steps 
require disrupting installation operations. 

6. Revise the real I/O configuration file to reflect the changes made by lOCP. The 
real I/O configuration file is DMKRIO for VM/SP and VM/SP HPO; for the 
VM/XA Systems Facihty, it is HCPRIO. Figure B-5 in Appendix B contains a 
sample DMKRIO listing that corresponds to the lOCP listing mentioned in Step 
1 (Figure B-1). Figure B-6 in Appendix B contains a sample HCPRIO Usting 
that also corresponds to Figure B-1. 

7. Generate the new VM/SP, VM/SP HPO, or VM/XA Systems FaciUty system. 

8. Shut down VM/SP, VM/SP HPO, or the VM/XA Systems Facihty. 

9. Perform a power-on reset of the processor complex with the new lOCDS 
specified as the source of your configuration data. You use the lOCDSM 
(SYS021) frame to select the active lOCDS and the CONFIG (SYS020) frame to 
perform a power-on reset. (See the operator's guide for the system console that 
appUes to your processor complex.) 

10. Load (IPL) VM/SP, VM/SP HPO or the VM/XA Systems Facihty. 

1 1 . Test the new configuration. Follow the procedures established for your 
installation. 

12. If your processor complex has only a level AO and Al (LVLO and LVLl) 
lOCDS, switch the two data sets after the new I/O configuration has been tested. 
To switch data sets, use action 3, SWITCH DS A/B, on the CONFIG (SYS020) 
frame. This action allows you to execute lOCP again and to write to and test 
another I/O configuration in the Al lOCDS. 

13. Save the file you used in Step 2 to provide a backup. 

Method Two: 

This method shows how an installation can redefine and replace an existing I/O 
configuration data set when VM/SP or VM/SP HPO Release 1 is running in single 
processor mode. Single processor mode allows an installation to dedicate a 
processor to an MVS V = R virtual machine. When single processor mode is active, 
do not issue an lOCP command with a write option or a configuration report 
option. (Note that the MVS V = R user cannot run the MVS version of lOCP when 
single processor mode is active if the user specifies that lOCP is to write to the 
processor controller or read from the processor controller.) 

Note: See "Restrictions" earlier in this chapter for information about running lOCP 
under VM/SP HPO in single processor mode. 
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Follow these steps: 

You may perform Steps 1 through 5 when single processor mode is active. Because 
you can do these steps while single processor mode is active, you can check lOCP 
macro instructions for errors without disrupting normal installation operations. 

1 . Update the input file that contains the lOCP macro instructions to reflect your 
new I/O configuration. Figure B-4 in Appendix B contains a hsting of a sample 
lOCP input file. 

2. Execute the VM version of IOC? to check the input file you updated in Step 1 
above. Use the NOWRTCDS option on the CMS lOCP command. Do not 
specify any configuration report options on the lOCP command. 

3. Correct any errors on the lOCP macro instructions and rerun lOCP (Step 2). 

4. Revise the DMKRIO file to reflect the changes made by lOCP. Figure B-5 in 
Appendix B contains a sample DMKRIO listing that corresponds to the lOCP 
listing mentioned in Step 1 . 

5. Generate the new VM/SP or VM/SP HPO system. 

Steps 6 through 8 require disrupting operation of the MVS virtual machine. 

6. Quiesce the MVS system, then reset the MVS virtual machine. The MVS V = R 
user must issue the CP command SYSTEM RESET or LOGOFF. 

7. Turn single processor mode off. 

8. Execute the lOCP program by issuing the lOCP command with a write opdon 
(WRTCDS, WRTAx, or WRTBx). This option writes the I/O configurafion to 
the specified lOCDS in the processor controller. Note that you must have 
privilege class C. 

You perform Steps 9 through 14 when you wish to use the new lOCDS you created 
in Step 8. Perform these steps at a convenient time, because these steps require 
disrupdng installation operations. 

9. Shut down VM/SP or VM/SP HPO. 

10. Perform a power-on reset of the processor complex with the new lOCDS 
specified as the source of your configuration data. You use the lOCDSM 
(SYS021) frame to select the active lOCDS and the CONFIG (SYS020) frame to 
perform the power-on reset. (See the operator's guide for the system console 
that applies to your processor complex.) 

11. Load (IPL) VM/SP or VM/SP HPO. 

12. Test the new configuration. Follow the procedures estabhshed for your 
installation. 

13. If your processor complex has only a level AO and Al (LVLO and LVLl) 
lOCDS, switch the data sets after the new I/O configuration has been tested. To 
switch data sets, use action 3, SWITCH DS A/B, on the CONFIG (SYS020) 
frame. This action allows you to execute lOCP again and to write to and test 
another I/O configuration in the Al lOCDS. 

14. Vary the second processor logically offline by issuing the command VARY 
OFFLINE PROCESSOR VLOG. 

15. Turn single processor mode on. 

16. Load (IPL) MVS. 

17. Save the file you used in Step 2 to provide a backup. 
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Chapter 4. Executing the Stand-Alone Version of lOCP 



The stand-alone version of lOCP is shipped with the processor complex as a 
software program in a partitioned data set on the integrated processor controller file 
in the processor controller. You execute the stand-alone version of lOCP to define 
I/O configuration data when you are operating your system before installation of 
MVS, VM/SP, VM/SP HPO or the VM/XA Systems Facility, or when you are 
operating your system with a control program other than these. The stand-alone 
version can run in either 370 mode or 370-XA mode. 

You start and control the stand-alone version of lOCP from the system console or 
the service support console on the processor complex. When started, lOCP displays 
the lOCP primary menu (shown in Figure 4-4), which hsts the available functions. 
From this menu, you select the function you want to perform. lOCP then displays 
menus on which you enter data for a specific function, or enter a screen command to 
select another function. 

Note: When you enter configuration data on the menus, the characteristics, values, 
and restrictions that apply to the configuration data you enter for channel paths, 
control units, and I/O devices are the same as those described for the macro 
instructions. See "Specifying lOCP Macro Instructions" in Chapter 2 (MVS) or 
Chapter 3 (YM) for full information on specifying configuration data on the 
CHPID, CNTLUNIT, and lODEVICE macro instructions. 

To help you use the information in this chapter, the next topic provides a map of 
lOCP functions with references to the topics and menus in this chapter. The other 
topics in this chapter describe: 

How to start and end lOCP 

The layout of the lOCP menus 

The lOCP screen commands 

The menus displayed by lOCP 

Selected examples of executing functions of lOCP 

How to dump the lOCP storage area 

The wait state codes issued bv lOCP 
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Guide to Using the Stand-Aione Version of lOCP 

To help you use the information in this chapter, the following diagram provides a 
map of the lOCP functions with references to the topics and figures in this chapter 
that describe how to perform the function. 



Start stand-alone lOCP (See topic "Starting and Ending lOCP") 



Is this a generation of an initial lOCDS? 



NO 



YES 



Is this a replacennent lOCDS? 



NO 



YES 



See topic "Generating an iOCDS on a 
New Processor Complex" later in this 
chapter. 

See topic "Replacing an IOCDS by Using 
Card-lnnage Input" later in this chapter. 



Is this a print configuration report or use of the service aid facility? 



NO 



YES 



Is the IOCDS you want printed in storage? 



YES 

-* 



"[no 



Select primary menu option 7 — then see figure 4-1 7 



"See figure 4-16 



Is this a screen entry change to the IOCDS? (display, add, alter, or delete function) 



Terminate lOCP? 



NO 



YES 



Select a function 
on the primary 
menu (figure 4-1 ) 

I 



■Enter END - 
press ENTER 

L|f the 
IOCDS was 
updated — 
test the new 
configuration 
(See steps 1 1 
and 12 in 
the topic 
"Replacing 
an IOCDS by 
Using Card- 
Image Input" 
later in this 
chapter.) 



NO 



YES 



Is the IOCDS to be changed in storage? 



YES 



NO 



See the note in the topic 
"Primary Menu" later in 
this chapter. 



•—Select primary menu option 7 — then see figure 4-17 

I 



Is this a display function? 



NO 



YES 



Is this an add function? 



NO 



YES 



Is this an alter function? 



NO 



YES 



Is this a delete function? 



NO 

-« — 



YES 



See figure 4-2 



See figure 4-3 



See figure 4-4 



See figure 4-5 



Are updates complete? 



J NO 



YES 



Has updated IOCDS been written to the processor controller? 



YES 

-* — 



NO 
' — Select primary menu option 8 — then see figure 4-18 



Is a configuration report needed? 



NO 

< — 



YES 



■See figure 4-16 
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starting and Ending lOCP 



To start the stand-alone version of lOCP, you must use a console correctly 
configured with the processor that will execute lOCP. Although you can execute 
lOCP on only one processor at a time, the stand-alone version of lOCP requires the 
entire processor complex to operate. (The command lOCPn causes a system reset 
and the clearing of storage before loading lOCP.) 

The following steps describe how you start the stand-alone version of lOCP on the 
system console or the service support console. 

1 . Determine if there are any analysis routines (ARs) currently running by hitting 
the ATTN key on the service console. If there are analysis routines running, 
you will receive the following message: 



"ATTN Flag now set 

To continue, enter D60. 



To terminate, enter DEND. 



If you do not receive this message, go to Step 2. 

Either enter DGO to allow the analysis routines to complete and run lOCP at a 
later time, or enter DEND to cancel the analysis routines. (The analysis routine 
that is currently running will complete.) Go to Step 2. 

If you cancel the analysis routines to run lOCP, restart the routines at the 
completion of lOCP by entering: 



"F MMC06O" 

and selecting "Resume LOGOUT Analysis". 

This will resume LOGOUT analysis. 

2. Key in the following console command, replacing n with the number of the 
processor (0, 1, 2, or 3) that will execute lOCP. (The A side has processors and 
2; the B side has processors 1 and 3. A uniprocessor has only processor 2.) 




Press ENTER. 

3. Wait for a response. 

If the console is in program mode, lOCP displays the primary menu 
(Figure 4-4). Go to Step 5. 

If the console is not in program mode, lOCP displays the following message: 



ICP501A TYPE "PRG": PRESS "ALT", "CMD" KEYS: 
TYPE "PRGATTN": PRESS "ENTER" 
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4. Respond to message ICP501A by performing the following steps, which put the 
console in program mode and cause a program attention. 

a. To put the console in program mode, key in the following console 
command: 




b. To display the following message, press and hold down the ALT key and 
then press the CMD key while holding down the ALT ^key. 



CONSOLE MODE CHANGED 



c. To cause a program attention, key in the following console command: 



PRGATTN 



d. Press ENTER. 

5. lOCP displays the primary menu (Figure 4-4) and you can start operating 
lOCP. 

For you to communicate with lOCP, the console must be in program mode. 
Whenever the console is in FDC (frame dependent command) mode and lOCP tries 
to change any line in the display other than the message line, the processor displays 
message CF INVOCATION ERROR. RC = 52. This message means the console is 
not in program mode. lOCP also displays message ICP501A (except when lOCP is 
changing Une 11 of Figure 4-20 and Figure 4-21). Use Steps 3a and 3b to put the 
console into program mode. To end lOCP operation, enter the END screen 
command on any lOCP menu. lOCP enters a disabled wait state and the audible 
alarm may sound. To reset the audible alarm, you must be in FDC mode (the 
console is still in program mode). To take the console out of program mode; key in 
FDC, press and hold down the ALT key, and press the CMD key while holding 
down the ALT key. Once you are in FDC mode, type RSTALM on the bottom Hne 
and press ENTER to reset the alarm. To restart lOCP (when lOCP is in steerage 
and the console is in FDC mode), key in SYSRESET and press ENTER. Then key 
in RESTART CPn, where n is the processor number (0, 1 , 2, or 3), and press 
ENTER. lOCP displays message ICP501A. (When you restart lOCP, the lOCDS 
in storage is reinitialized.) 
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Layout of the Menu Screens 



lOCP uses 24 lines to display menus. The lines contain the following data: 



Figure 4-1. Layout of Menu Screen 


Line 


Description 


1 


I/O CONFIGURATION PROGRAM 


2 


lOCP menu name (function to be performed) 


3 


blank 


4-18 


variable - contains specific instructions for the menus. You use these 
hnes to enter configuration data and to select options. 


19 


blank 


20-21 


Usts the lOCP screen commands available for you to enter on line 24 
of the menu currently displayed. Screen commands allow you to 
select and change the functions you want to perform. 


22 


system status indicators - not used by lOCP. 


23 


displays the messages that indicate error conditions or the completion 
of requested functions. 


24 


used to enter lOCP screen commands. 



Although they do not appear on the lOCP screens, line numbers are shown next to 
the screens in this manual and are referred to in the text to describe the menus. 
When a menu is displayed, the cursor position is to the right of the arrow where you 
can start to enter data. In the event of an entry error, the cursor position is at the 
incorrect data. Figure 4-4 through Figure 4-22 show the lOCP menus. In 
Figure 4-9 through Figure 4-11, the optional 370 information (channel number and 
channel set) is information required only for 370 mode operation. In Figure 4-15 
through Figure 4-17, the optional information (preferred path) appUes only to 
370-XA mode operation. 
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Screen Commands 



The screen commands that you can issue when a specific menu is displayed are 
shown on hnes 20 and 21 of the menu. To issue a screen command, enter the 
command on hne 24 and press ENTER. 

The ADD, ALTER, and DISPLAY screen commands can be entered in the form 
"command = value". This "command = value" screen command allows you to switch 
to or repeat a function without the need to return to the selection menu or primary 
menu. For example, if you have the control unit display menu (Figure 4-12) on the 
screen and want to add control unit number 2AA, enter ADD = 2AA and press 
ENTER to select the add control unit menu (Figure 4-13) for control unit number 
2AA. 

The lOCP screen commands are: 



Figure 4-2 (Page 1 of 2). lOCP Screen command 


Command 


Description 


ADD 


Terminates the function in use for the menu currently 
displayed and selects the add selection menu 
(Figure 4-6). 


A 




ADD = value 


Terminates the function in use for the menu currently 
displayed and performs the function of the add 
selection menu (Figure 4-6) for the specified value. 


A = value 


Enter ADD = value on the display, add, or alter 
channel path menus (Figure 4-9, Figure 4-10, or 
Figure 4-11) to select the add channel path menu 
(Figure 4-10) for the channel path specified by value. 
Enter ADD = value on the display, add, or alter 
control unit menus (Figure 4-12, Figure 4-13, or 
Figure 4-14) to select the add control unit menu 
(Figure 4-13) for the control unit specified by value. 
Enter ADD = value on the display, add, or alter I/O 
device menus (Figure 4-15, Figure 4-16, or 
Figure 4-17) to select the add I/O device menu 
(Figure 4-16) for the I/O device specified by value. 


ALTER Terminates 
the function in use for 
the menu currently 
displayed and selects 
the alter selection 
menu (Figure 4-7). 




AL 




ALTER = value 


Use ALTER = value to switch to or repeat the alter 
function in the same manner as described for 
ADD = value. 


AL = value 
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Figure 4-2 (Page 2 of 2). lOCP Screen command 


Command 


Description 


DELETE 


Terminates the function in use for the menu currently 
displayed and selects the delete selection menu 
(Figure 4-8). 


DISPLAY 


Terminates the function in use for the menu currently 
displayed and selects the display selection menu 
(Figure 4-5). 


D 


. . 


DISPLAY = value 


Use DISPLAY = value to switch to or repeat the 
display function in the same manner as described for 
ADD = value. 


D = value 




END 


Terminates lOCP. If you have modified the lOCDS 
in storage, and have not written the lOCDS to an 
lOCDS in the processor controller, lOCP does not 
terminate until you respond to the end lOCP menu 
(Figure 4-22). When lOCP enters the disabled wait 
state, the audible alarm may sound. If the alarm 
sounds, put the console into FDC mode, type 
RSTALM on the bottom line, and press ENTER to 
reset the alarm. 


MENU 


Terminates the function in use for the menu currently 
displayed and displays the primary menu 
(Figure 4-4). 


M' ~ 




RESHOW 


Clears the screen and restores the previous lOCP 
menu to the screen. lOCP restores user-entered data, 
if lOCP received the data. Any message previously 
displayed is not reshown. 


R 




WRITE 


Terminates the function in use for the menu currently 
displayed and selects the write lOCDS to the 
processor controller file menu (Figure 4-21). 


W 
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Menu Screens 



This topic describes the menus displayed by lOCP and explains how you use the 
menus. 



Primary Menu 



The primary menu shown in Figure 4-4 appears when you start lOCP or issue the 
MENU screen command to request the primary menu. 



You select the function that you want to perform by keying in a menu number (1 
through 8) on hne 14 and pressing ENTER. 

The menu displayed when you enter a number on the primary menu is: 



Figure 4-3. Primary Menu 


Menu 
Number 


Menu 
Displayed 


Function 


1 


Display Selection (Figure 4-5) 


Used to display configuration 
data from the lOCDS in 
storage. 


2 


Add Selection (Figure 4-6) 


Used to add configuration 
data to the lOCDS in storage. 


3 


Alter Selection (Figure 4-7) 


Used to alter configuration 
data in the lOCDS in storage. 


4 


Delete Selection (Figure 4-8) 


Used to delete configuration 
data from the lOCDS in 
storage. 


5 


Build lOCDS from Cards 
(Figure 4-18) 


Used to read card-image 
macro instructions from a card 
reader or magnetic tape, 
generate an lOCDS in storage, 
and produce reports of the 
generated lOCDS. 


6 


Print lOCDS Configuration 
Reports with Service Aid 
Facihty (Figure 4-19) 


Used to produce configuration 
reports from the lOCDS in 
storage on a channel -attached 
printer, or to access the service 
aid facihty to swap channel 
path information in the 
lOCDS and then print reports. 


7 


Read lOCDS from the 
Processor Controller File 
(Figure 4-20) 


Used to read one or more 
lOCDS(s) from the processor 
controller into the lOCDS 
storage area. 


8 


Write lOCDS to the Processor 
Controller File (Figure 4-21) 


Used to write the lOCDS in 
storage to one or more 
lOCDS(s) in the processor 
controller. 
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Line 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
2G 
21 
22 
23 
24 



I/O CONFIGURATION PROGRAM 
PRIMARY MENU 

SELECT MENU NUMBER AND ENTER BELOW: 

1. DISPLAY CHANNEL PATH, CONTROL UNIT, OR I/O DEVICE INFORMATION 

2. ADD CHANNEL PATH, CONTROL UNIT, OR I/O DEVICE 

3. ALTER CHANNEL PATH, CONTROL UNIT, OR I/O DEVICE 

4. DELETE CHANNEL PATH, CONTROL UNIT, OR I/O DEVICE 

5. BUILD lOCDS FROM CARDS 

6. PRINT lOCDS CONFIGURATION REPORTS WITH SERVICE AID FACILITY 

7. READ lOCDS FROM THE PROCESSOR CONTROLLER FILE 

8. WRITE lOCDS TO THE PROCESSOR CONTROLLER FILE 

ENTER MENU NUMBER ==> 



END 
MENU 



RESHOW 



system status 
message line 
command line 



Figure 4-4. Primary Menu Screen 



Note: lOCP processes your requests to display, add, alter, delete, and print 
configuration data (menu numbers 1, 2, 3, 4, and 6) from the lOCDS located in 
central storage. This lOCDS in storage represents one of the following: 

• The lOCDS previously read into storage using the read lOCDS from the 
processor controller file menu (number 7). 

• The lOCDS previously generated in storage from card-image input using the 
build lOCDS from cards menu (number 5). 

• A null lOCDS in storage created when you start lOCP. 

If you modify the lOCDS in storage and want to write the modified lOCDS to one 
or more lOCDS(s) in the processor controller file, use menu number 8. 

See the examples later in this chapter for detailed information on executing functions 
oflOCP. 
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Display Selection 



The screen shown in Figure 4-5 appears when you enter menu number 1 on the 
primary menu screen (Figure 4-4) or enter the DISPLAY screen command. 

You use this menu to select the data you want to display from the lOCDS in 
storage. 

On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/number for the record you want to display. 

Press ENTER. lOCP displays the requested data on the channel path display screen 
(Figure 4-9), the control unit display screen (Figure 4-12), or the I/O device display 
screen (Figure 4-15). 
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22 
23 
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I/O CONFIGURATION PROGRAM 
DISPLAY SELECTION 



ENTER DISPLAY SELECTION FOR ONLY 

CHANNEL PATH ID 

CONTROL UNIT NUMBER 



IE OF THE FOLLOWING: 
_(2 HEX) ==> 



DEVICE ADDRESS/NUMBER_ 



(1 TO 3 
(1 TO 3 



HEX) 
HEX) 



ADD 

ALTER DELETE 
system status 
message line 
command 1 i ne 



END 
MENU 



RESHOW 



Figure 4-5. Display Selection Screen 
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Add Selection 



The screen shown in Figure 4-6 appears when you enter menu number 2 on the 
primary menu screen (Figure 4-4) or enter the ADD screen command. 

You use this menu to specify the channel path, control unit, or I/O device that you 
want to add to the lOCDS in storage. Before adding a control unit to the lOCDS, 
you must add the channel path(s) to which the control unit attaches. Before adding 
an I/O device, you must add the control unit(s) to which the I/O device is assigned. 

On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/ number for the record you want to add. 

Press ENTER. lOCP displays the add channel path screen (Figure 4-10), the add 
control unit screen (Figure 4-13), or the add I/O device screen (Figure 4-16) to 
allow you to enter complete data for the record you want to add. 
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I/O CONFIGURATION PROGRAM 
ADD SELECTION 

ENTER ADD SELECTION FOR ONLY ONE OF THE FOLLOWING: 

CHANNEL PATH ID (2 HEX) ==> 

CONTROL UNIT NUMBER (1 TO 3 HEX) ==> 

DEVICE ADDRESS/NUMBER_(1 TO 3 HEX) ==> 



DISPLAY 
ALTER DELETE 
system status 
message line 
command 1 i ne 



END 
MENU 



RESHOW 



Figure 4-6. Add Selection Screen 
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Alter Selection 



The screen shown in Figure 4-7 appears when you enter menu number 3 on the 
primary menu screen (Figure 4-4) or enter the ALTER screen command. 

You use this menu to select and identify the channel path, control unit, or I/O device 
whose data you want to alter in the lOCDS in storage. 

On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/number that identifies the record that you want to alter. 

Press ENTER. lOCP displays the alter channel path screen (Figure 4-11), the alter 
control unit screen (Figure 4-14), or the alter I/O device screen (Figure 4-17) to 
allow you to alter the existing data for the record selected. 
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I/O CONFIGURATION PROGRAM 
ALTER SELECTION 

ENTER ALTER SELECTION FOR ONLY ONE OF THE FOLLOWING: 

CHANNEL PATH ID (2 HEX) ==> 

CONTROL UNIT NUMBER (1 TO 3 HEX) ==> 

DEVICE ADDRESS/NUMBER_(1 TO 3 HEX) ==> 



ADD DISPLAY 
DELETE 
system status 
message line 
command line 



END 
MENU 



RESHOW 



Figure 4-7. Alter Selection Screen 
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Delete Selection 



The screen shown in Figure 4-8 appears when you enter menu number 4 on the 
primary menu screen (Figure 4-4) or enter the DELETE screen command. 

You use this menu to delete a channel path, control unit, or I/O device record from 
the lOCDS in storage. 

If you delete a channel path, lOCP deletes all references to that channel path from 
control unit and I/O device records. Any control unit and/or I/O device record that 
references only that channel path will be deleted entirely. 

If you delete a control unit, lOCP deletes all references to that control unit from I/O 
device records. Any I/O device record that references only that control unit will be 
deleted entirely. 

On line 5, 6, or 7, key in the channel path identifier, control unit number, or I/O 
device address/number for the record that you want to delete. 

Press ENTER. The selected record is deleted from the lOCDS in storage. 
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I/O CONFIGURATION PROGRAM 
DELETE SELECTION 

ENTER DELETE SELECTION FOR ONLY ONE OF THE FOLLOWING: 

CHANNEL PATH ID (2 HEX) ==> 

CONTROL UNIT NUMBER (1 TO 3 HEX) ==> 

DEVICE ADDRESS/NUMBER_(1 TO 3 HEX) ==> 



ADD 
ALTER 

system status 
message line 
command 1 i ne 



DISPLAY 



END 
MENU 



RESHOW 



Figure 4-8. Delete Selection Screen 
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Channel Path Display 

The screen shown in Figure 4-9 appears when you have entered a channel path 
identifier on hne 5 of the display selection screen (Figure 4-5) or entered the 
DISPLAY = value screen command. 

This screen displays, to the right of the arrows, the data for the requested channel 
path. The optional information (channel number and channel set) is displayed only 
if it was specified. For 370-XA mode, the optional information is optional. For 370 
mode, the optional information is information required for the processor to access 
the devices attached to the channel path. 

Enter a screen command and press ENTER to select another menu. 
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I/O CONFIGURATION PROGRAM 
CHANNEL PATH DISPLAY 



REQUIRED INFORMATION: 



CHANNEL PATH ID 


(2 HEX) 


==> 


CHANNEL TYPE 


_(BL,BY) 


==> 


OPTIONAL 370 INFORMATION: 






CHANNEL NUMBER 


(1 HEX) 


==> 


CHANNEL SET 


(0,1) 


==> 



ADD DISPLAY 
ALTER DELETE 
system status 
message line 
command line 



END 
MENU 



RESHOW 



Figure 4-9. Channel Path Display Screen 
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Add Channel Path 



The screen shown in Figure 4-10 appears when you have entered a channel path 
identifier on hne 5 of the add selection screen (Figure 4-6) or entered the 
ADD = value screen command. 

You use this menu to add a channel path to the lOCDS in storage. 

On line 5, lOCP displays the channel path identifier of the channel path you are 
adding. 

On hnes 6, 9, and 10, key in the channel path information for the channel path that 
you want to add. For 370-XA mode, the optional information is optional. For 370 
mode, the optional information is required for the processor to access the devices 
attached to the channel path. 

Press ENTER to add the channel path record to the lOCDS in storage. 
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I/O CONFIGURATION PROGRAM 
ADD CHANNEL PATH 

ENTER REQUIRED INFORMATION: 

CHANNEL PATH ID (2 HEX) ==> 

CHANNEL TYPE (BL,BY) ==> 



ENTER OPTIONAL 370 ASSIGNMENT: 

CHANNEL NUMBER (1 HEX) ==> 

CHANNEL SET (0,1) ==> 



ADD DISPLAY 

ALTER DELETE 

system status 
message line 
command line 



END 
MENU 



RESHOW 



Figure 4-10. Add Channel Path Screen 
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Alter Channel Path 

The screen shown in Figure 4-11 appears when you have entered a channel path 
identifier on line 5 of the alter selection screen (Figure 4-7) or entered the 
ALTER = value screen command. 

You use this menu to alter the definition of an existing channel path in the lOCDS 
in storage. When this screen is displayed, it shows the existing information for the 
channel path you have selected to alter. 

On Hne 5, lOCP displays the channel path identifier of the channel path you are 
altering. You cannot alter the channel path identifier itself on this screen. To alter 
the channel path identifier, delete the existing definition of the channel path from the 
lOCDS in storage and add a new one. 

On lines 6, 9, and 10, lOCP displays the existing channel path information, which 
you can alter by keying in new information to define the channel path. The data 
that you can alter is intensified on the screen. 

For 370-XA mode, the optional information (Unes 9 and 10) is optional. 

For 370 mode, the optional information is information required for the processor to 
access the device attached to the channel path. 

Press ENTER to add the altered channel path record to the lOCDS in storage. 
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I/O CONFIGURATION PROGRAM 
ALTER CHANNEL PATH 



ENTER REQUIRED INFORMATION: 

CHANNEL PATH ID (2 HEX) 

CHANNEL TYPE (BL,BY) 



ENTER OPTIONAL 370 ASSIGNMENT: 

CHANNEL NUMBER (1 HEX) 

CHANNEL SET (0,1) 



==> 



==> 

==> 



ADD DISPLAY 
ALTER DELETE 
system status 
message line 
command line 



END 
MENU 



RESHOW 



Figure 4-11. Alter Channel Path Screen 
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Control Unit Display 

The screen shown in Figure 4-12 appears when you have entered a control unit 
number on Une 6 of the display selection screen (Figure 4-5) or entered the 
DISPLAY = value screen command. 

This screen displays, to the right of the arrows, the data for the requested control 
unit. 

Enter a screen command and press ENTER to select another menu. 



Line 










1 






I/O CONFIGURATION PROGRAM 




2 

3 
4 






CONTROL UNIT DISPLAY 






REQUIRED INFORMATION: 




5 




CONTROL UNIT NUMBER (1 TO 3 HEX) 


==> 


6 




CU TYPE NUMBER (1 TO 5 ALPHA) 


==> 


7 




CONTROL UNIT SHARED? (Y,YB,N) 


==> 


8 




PROTOCOL_ 


(D,S.S4) 


==> 


9 




CHPID #1 


(2 HEX) 


==> 


10 




UA SET #1: 


FROM (2 HEX) 


==> 


11 




UA SET #1: 


TO (2 HEX) 


==> 


12 




ADDITIONAL CHPID(S): 




13 




CHPID#2 => 


CHPID#3 => 


CHPID#4 => 


14 




ADDITIONAL UNIT ADDRESS SET(S): 




15 




SET FROM 


TO SET FROM TO 


SET FROM 


16 




2 => 


3 => 


4 => 


17 




5 => 


6 => 


7 => 


18 




8 => 






19 










20 


ADD 


DISPLAY 


END RESHOW 




21 


ALTER 


DELETE 


MENU 




22 


system status 






23 


message line 






24 


command line 







TO 



Figure 4-12. Control Unit Display Screen 
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Add Control Unit 



The screen shown in Figure 4-13 appears when you have entered a control unit 
number on line 6 of the add selection screen (Figure 4-6) or entered the 
ADD = value screen command. 

You use this menu to add a control unit to the lOCDS in storage. Before adding a 
control unit, you must add the channel path(s) to which the control unit attaches. 

On hne 5, lOCP displays the control unit number of the control unit you are adding. 

On hnes 6 through 18, key in the control unit information for the control unit that 
you want to add. If the control unit connects to more than one channel path, enter 
the additional channel path identifiers (chpids) on hne 13. If the control unit can 
recognize sets of unit addresses, enter the additional sets on lines 16 through 18. 
You can specify a maximum of eight sets of addresses. 

Press ENTER to add the control unit record to the lOCDS in storage. 



Line 






1 


I/O CONFIGURATION PROGRAM 




2 

3 
4 


ADD CONTROL UNIT 




ENTER REQUIRED INFORMATION: 




5 


CONTROL UNIT NUMBER (1 TO 3 HEX) 


==> 


6 


CU TYPE NUMBER (1 TO 5 ALPHA) 


==> 


7 


CONTROL UNIT SHARED? (Y,YB,N) 


==> 


8 


PROTOCOL (D,S,S4) 


==> 


9 


CHPID #1 (2 HEX) 


==> 


IG 


UA SET #1: FROM (2 HEX) 


==> 


11 


UA SET #1: TO (2 HEX) 


==> 


12 


ENTER ADDITIONAL CHPID(S): 




13 


CHPID#2 => CHPID#3 => 


CHPID#4 => 


14 


ENTER ADDITIONAL UNIT ADDRESS SET(S): 




15 


SET FROM TO SET FROM TO 


SET FROM 


16 


2 => 3 => 


4 => 


17 


5 => 6 => 


7 => 


18 


8 => 




19 






2G 


ADD DISPLAY END RESHOW 




21 


ALTER DELETE MENU 




22 


system status 




23 


message line 




24 


command line 





TO 



Figure 4-13. Add Control Unit Screen 
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Alter Control Unit 



The screen shown in Figure 4-14 appears when you have entered a control unit 
number on Une 6 of the alter selection screen (Figure 4-7) or entered the 
ALTER = value screen command. 

You use this menu to alter the definition of an existing control unit in the lOCDS in 
storage. When the screen is displayed, it shows the existing information for the 
control unit you have selected to alter. 

On line 5, lOCP displays the control unit number of the control unit you are 
altering. You cannot alter the control unit number itself on this screen. To alter the 
control unit number, delete the existing definition of the control unit from the 
lOCDS in storage and add a new one. 

On lines 6 through 18, lOCP displays the existing control unit information, which 
you can alter by keying in new information to define the control unit. The data that 
you can alter is intensified on the screen. 

If the control unit connects to more than one channel path, enter the additional 
channel path identifiers (chpids) on Une 13. If the control unit can recognize sets of 
unit addresses, enter the additional sets on Hues 16 through 18. You can specify a 
maximum of eight sets of addresses. 

Press ENTER to add the altered control unit record to the lOCDS in storage. 



Line 






1 


I/O CONFIGURATION PROGRAM 




2 

3 
4 


ALTER CONTROL UNIT 




ENTER REQUIRED INFORMATION; 




5 


CONTROL UNIT NUMBER (1 TO 3 HEX) 


==> 


6 


CU TYPE NUMBER (1 TO 5 ALPHA) 


==> 


7 


CONTROL UNIT SHARED? (Y,YB,N) 


==> 


8 


PROTOCOL (D,S,S4) 


==> 


9 


CHPID #1 (2 HEX) 


==> 


10 


UA SET #1: FROM (2 HEX) 


==> 


11 


UA SET #1: TO (2 HEX) 


==> 


12 


ENTER ADDITIONAL CHPID(S): 




13 


CHPID#2 => CHPID#3 => 


CHPID#4 => 


14 


ENTER ADDITIONAL UNIT ADDRESS SET(S): 




15 


SET FROM TO SET FROM TO 


SET FROM 


16 


2 => 3 => 


4 => 


17 


5 => 6 => 


7 => 


18 


8 => 




19 






20 


ADD DISPLAY END RESHOW 




21 


ALTER DELETE MENU 




22 


system status 




23 


message line 




24 


command line 





TO 



Figure 4-14. Alter Control Unit Screen 
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I/O Device Display 

The screen shown in Figure 4- 1 5 appears when you have entered an I/O device 
number/address on Une 5 of the display selection screen (Figure 4-5) or entered the 
DISPLAY = value screen command. 

This screen displays, to the right of the arrows, the data for the requested I/O device. 

The optional information appears only if it was defined for 370-XA mode. 

Enter a screen command and press ENTER to select another menu. 



Line 








1 




I/O CONFIGURATION PROGRAM 




2 

3 
4 




I/O DEVICE DISPLAY 






REQUIRED INFORMATION: 




5 




DEVICE NUMBER/ADDRESS (1 TO 3 HEX) 


==> 


6 




UNIT ADDRESS (2 HEX) 


==> 


7 




DEVICE TYPE NUMBER (1 TO 5 ALPHA) 


==> 


8 




DEVICE TYPE MODEL (1 TO 2 ALPHA) 


==> 


9 




CONTROL UNIT NUMBER (1 TO 3 HEX) 


==> 


10 




TIMEOUT? (Y,N) 


==> 


11 




OPTIONAL INFORMATION: 




12 




PREFERRED PATH (2 HEX) 


==> 


13 








14 




ADDITIONAL CONTROL UNIT NO(S): 




15 




CU N0#2 => CU N0#3 => 


CU N0#4 => 


16 








17 








18 








19 
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ADD 


DISPLAY END RESHOW 
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ALTER 


DELETE MENU 




22 


system status 




23 


message line 




24 


command line 





Figure 4-15. I/O Device Display Screen 
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Add I/O Device 



The screen shown in Figure 4-16 appears when you have entered an I/O device 
address/number on hne 5 of the add selection screen (Figure 4-6) or entered the 
ADD = value screen command. 

You use this menu to add an I/O device or set of I/O devices to the lOCDS in 
storage. Before adding an I/O device or set of I/O devices, you must add the control 
unit(s) to which the I/O device(s) are assigned. 

On line 5. lOCP displays the device address/number of the I/O device you are 
adding. 

On lines 6 through 18, key in the I/O device information for the I/O device(s) that 
you want to add. To add more than one I/O device, key in the ending address of 
the added devices on line 18. For example, if you have selected to add device 210 
(which appears on line 5) and want to add a set of devices with addresses 210 
through 2 IF; then key in IF on line 18. 

Specify the optional information (preferred path) only for a device used in 370-XA 
mode. 

Press ENTER to add the I/O device record(s) to the lOCDS in storage. 



Line 
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I/O CONFIGURATION PROGRAM 




2 
3 
4 




ADD I/O DEVICE 




ENTER REQUIRED INFORMATION: 




5 




DEVICE NUMBER/ADDRESS_(1 TO 3 HEX) 


==> 


6 




UNIT ADDRESS (2 HEX) 


==> 


7 




DEVICE TYPE NUMBER (1 TO 5 ALPHA) 


==> 


8 




DEVICE TYPE MODEL (1 TO 2 ALPHA) 


==> 


9 




CONTROL UNIT NUMBER (1 TO 3 HEX) 


==> 


10 




TIMEOUT? (Y,N) 


==> 


11 


ENTER OPTIONAL INFORMATION: 




12 
13 
14 




PREFERRED PATH (2 HEX) 


==> 


ENTER ADDITIONAL CONTROL UNIT NO(S): 




15 




CU N0#2 => CU N0#3 => 


CU N0#4 => 


16 








17 


ENTER - 


IF ADDING MULTIPLE DEVICES: 




18 




LAST UNIT ADDRESS (2 HEX) 


==> 
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ADD 


DISPLAY END RESHOW 
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ALTER 


DELETE MENU 
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system 


status 




23 


message 


line 




24 


command 
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Figure 4-16. Add I/O Device Screen 
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Alter I/O Device 



The screen shown in Figure 4-17 appears when you have entered an I/O device 
address on Hne 7 of the alter selection screen (Figure 4-7) or entered the 
ALTER = value screen command. 

You use this menu to alter the definition of an existing I/O device in the lOCDS in 
storage. When the screen is displayed, it shows the existing information for the I/O 
device you have selected to alter. 

On line 5, lOCP displays the I/O device number/address of the I/O device you are 
altering. You cannot alter the device number/address itself on this screen. To alter 
the device number/address, delete the existing definition of the I/O device from the 
lOCDS in storage and add a new one. 

On lines 6 through 15, lOCP displays the existing I/O device information, which you 
can alter by keying in new information to define the I/O device. The data that you 
can alter is intensified on the screen. 

The optional information appears only if it was defined for 370-XA mode. 

Press ENTER to add the altered I/O device record to the lOCDS in storage. 
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I/O CONFIGURATION PROGRAM 
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ALTER I/O DEVICE 




ENTER REQUIRED INFORMATION: 




5 


DEVICE NUMBER/ADDRESS (1 TO 3 HEX) 


==> 


6 


UNIT ADDRESS (2 HEX) 


==> 


7 


DEVICE TYPE NUMBER (1 TO 5 ALPHA) 


==> 


8 . 


DEVICE TYPE MODEL (1 TO 2 ALPHA) 


==> 


9 


CONTROL UNIT NUMBER (1 TO 3 HEX) 


==> 


10 


TIMEOUT? (Y.N) 


==> 


11 


ENTER OPTIONAL INFORMATION: 




12 


PREFERRED PATH (2 HEX) 


==> 


13 
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ENTER ADDITIONAL CONTROL UNIT NO(S): 




15 


CU N0#2 =>. CU N0#3 => 


CU N0#4 => 
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system status 
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Figure 4-17. Alter I/O Device Screen 
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Build lOCDS from Cards 

The screen shown in Figure 4-18 appears when you enter menu number 5 on the 
primary menu screen (Figure 4-4). 

You use this menu to read card-image macro instructions from a card reader or 
magnetic tape, to generate an lOCDS in storage, and to produce reports of the 
generated lOCDS. For additional information on this menu, see the topic 
"Replacing an lOCDS by Using Card-Image Input"' later in this chapter. 

Note that the input and output devices you specify on this menu must be defined in 
the I/O configuration processed on the previous power-on reset or SYSIML CLEAR 
and must be available to the processor you are using to execute lOCP. The printer 
must also be initiahzed (the forms and print buffer must be loaded). While 
executing lOCP, assign exclusively to lOCP any devices and control units that lOCP 
uses. (Other systems should not share the devices and control units.) 

On hne 5, key in the device address/number of the input device that is to read the 
card-image input deck. On line 7, key in the type of input device (C for card reader 
or T for magnetic tape). lOCP assumes that the input records have a length of 80 
bytes and a block size of 80 to 32,800 bytes. 

On line 8, key in either Y (yes) to ignore non-IOCP input (for example, when you 
have a combined input deck containing lOCP and system generation macro 
instructions), or N (no) to flag non-IOCP input as errors (for example, when your 
input deck contains only lOCP macro instructions and parameters). 

If the input device is a tape drive: on line 11, key in the number of the physical file 
on the reel (such as 1, 2, or 3) that contains the lOCP input deck. The number on 
hne 1 1 should include any leading tape marks and/or files containing tape labels. 
lOCP will issue a rewind command followed by "n" (where n is one less than the 
number you specify on hne 11) forward space file command(s) to position the tape 
to the requested file. 

If the input device is a tape drive: on hne 12, key in the appropriate mode set 
command that applies to the tape drive (if other than the default of 03). 

On hne 9, key in the device address/number of the printer that is to print lOCP 
messages and reports or, key in NA if you do not have a printer available. If you 
use NA, ah lOCP messages and reports are lost. On hne 14, key in Y (yes), N (no), 
or NA (not applicable) for blocking printer data checks depending on the 
characteristics of the printer. On line 15, key in the maximum number of lines that 
you want on an output page (you can specify up to 99). The default is 55. (lOCP 
also defaults to 55 if you specify a value less than 11.) 

On hnes 16 and 17, respectively, lOCP displays time and date information that will 
appear at the top of each page of the lOCP configuration reports. The time and 
date displayed are either zeroes or values you provided on a previous menu screen. 
You can change the time and/or date displayed by keying in the values you want 
printed on the reports. On hne 16, key in the hour and minute values; on hne 17, 
key in the year and day values. (Note that the time and date entries you make do 
not activate the time-of-day clock.) 

Press ENTER to build the lOCDS in storage from the card-image input. 
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Line 

1 I/O CONFIGURATION PROGRAM 

2 BUILD lOCDS FROM CARDS 
3 

4 ENTER REQUIRED INFORMATION: 

5 INPUT DEVICE ADDRESS/NUMBER (3 HEX) = 

6 INPUT DEVICE TYPE (C=CARD READER) 

7 .(T=TAPE DRIVE) = 

8 IGNORE UNKNOWN CARD STATEMENTS? (Y,N) = 

9 OUTPUT PRINTER ADDR/NUMBER (3 HEX,NA) = 

10 ENTER IF THE "INPUT DEVICE TYPE" IS A TAPE DRIVE: 

11 FILE NUMBER _(1 to 2 DECIMAL) = 

12 MODE SET CMD (DEFAULT=03 (HEX)) = 

13 ENTER IF YOU SPECIFY AN "OUTPUT PRINTER ADDRESS": 

14 BLOCK PRINTER DATA CHECKS? (Y,N,NA) = 

15 LINES PER PAGE {DEFAULT=55 (DECIMAL)) = 

16 TIME (HOUR. MINUTE) (HH.MM) = 

17 DATE (YEAR.DAY(JULIAN)) (YY.DDD) = 

18 

19 

20 END RESHOW 

21 MENU 

22 system status 

23 message line 

24 command line 



Figure 4-18. Build lOCDS from Cards Screen 
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Print lOCDS Configuration Reports with Service Aid Facility 

The screen shown in Figure 4-19 appears when you enter menu number 6 on the 
primary menu screen (Figure 4-4). 

You use this menu to produce lOCP configuration reports of the lOCDS that is in 
storage. This menu also allows you to use the service aid facility to swap channel 
path information (reports are also produced when you use the service aid facility). 
See Chapter 5 for examples of lOCP configuration reports. 

Note that the output printer that you specify on this menu must be defined in the 
I/O configuration that was processed on the previous power-on reset or SYSIML 
CLEAR and must be available to the processor you are using to execute lOCP. The 
printer must also be initialized (the forms and print buffer must be loaded). While 
executing lOCP, assign exclusively to lOCP any devices and control units that lOCP 
uses. (Other systems should not share the devices and control units.) 

On Hne 5, key in the address/number of the printer that is to print the lOCP 
messages and reports. On hne 6, key in Y (yes), N (no), or NA (not applicable) for 
blocking printer data checks depending on the characteristics of the printer. On hne 
7, key in the maximum number of lines that you want on an output page (you can 
specify up to 99). The default is 55. (lOCP also defaults to 55 hues if you specify a 
value less than 1 1 .) 

On lines 8 and 9, respectively, lOCP displays time and date information that will 
appear at the top of each page of the reports. The time and date displayed are 
either zeroes or values you provided on a previous menu screen. You can change 
the time and/or date displayed by keying in the values you want printed on the 
reports. On hne 8, key in the hour and minute values; on hne 9, key in the year and 
day values. (Note that the time and date entries you make do not activate the 
time-of-day clock.) 

Note: This menu allows you to obtain reports of an lOCDS in storage that is in 
error. If you use this menu and the lOCDS in storage is in error, lOCP produces 
the reports followed by the appropriate error message describing the first detected 
error (such as one of the messages ICP300I through ICP307I). 



Press ENTER to produce the reports of the lOCDS in storage. 



Service Aid Facility 



Lines 12 and 13 are intended for use only by service personnel who are swapping 
(exchanging) cables to isolate channel path, control unit, or I/O device failures. To 
use the service aid facility, the unswapped (original) lOCDS must be in storage. 

Make the required entries on lines 5 through 9. On lines 12 and 13, you enter the 
channel path identifiers (chpids) that identify the cables you want to swap. Note 
that both channel paths must be the same type, either block or byte multiplexer. 

Press ENTER to swap the chpids and print reports. Before printing reports of the 
lOCDS in storage, lOCP will swap the two chpids on every control unit and I/O 
device entry in which they appear. In addition, lOCP also swaps (exchanges) all the 
channel path information between the two entered chpids. 
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The service personnel should review the printed configuration reports to verify the 
correct swapping of the channel paths. If the swapping is correct, use menu 8 
(Figure 4-21) to write the changed (new) lOCDS to one or more lOCDS(s) in the 
processor controller. You must use action A2 on the CONFIG (SYS020) frame to 
activate the new lOCDS. 



Line 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



I/O CONFIGURATION PROGRAM 
PRINT lOCDS CONFIGURATION REPORTS 

ENTER REQUIRED INFORMATION: 

OUTPUT PRINTER ADDRESS/NUMBER (3 HEX) 

BLOCK PRINTER DATA CHECKS? ^(Y,N,NA) 

LINES PER PAGE DEFAULT=55 (DECIMAL)) 

(HH.MM) 



TIME (HOUR. MINUTE) 

DATE (YEAR. DAY (JULIAN)). 



.(YY.DDD) ==: 



ENTER IF USING SERVICE AID FACILITY: 

CHPID #1 (SWAP WITH CHPID #2) (2 HEX) 

CHPID #2 (SWAP WITH CHPID #1) (2 HEX) 



END 
MENU 



RESHOW 



system status 
message line 
command line 



Figure 4-19. Print lOCDS Configuration Reports Screen 
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Read lOCDS from the Processor Controller File 

The screen shown in Figure 4-20 appears when you enter menu number 7 on the 
primary menu screen (Figure 4-4). 

You use this menu to read an lOCDS from the processor controller into the lOCDS 
storage area. 

On hne 5, key in the level of the lOCDS. You can enter only one value. The vahd 
entries depend on the number of I/O configuration data sets that your processor 
complex supports: 

• For two I/O configuration data sets, the vaUd entries are 0, AO, 1, and Al. 

• For four I/O configuration data sets, the vahd entries on the A side are 0, 1, AO, 
Al, A2, and A3; on the B side they are 0, 1, BO, Bl, B2, and B3. 

• For eight I/O configuration data sets, all of the entries are valid on a 3084 
Processor Complex operating in MP mode. 

Note: The value is the same as AO; 1 is the same as Al. 

Press ENTER to read the selected data set into storage. (After the read operation is 
completed, you can use menu 8 to display MSGl and MSG2 of the lOCDS read 
into storage.) You can now add, alter, display, and delete configuration data from 
the lOCDS in storage; you can also obtain reports of the lOCDS in storage. 

On line 11, lOCP displays the status of the read operation. After you press ENTER 
and lOCP begins read processing, the text on line 1 1 varies between NO 
READ/WRITE IN PROGRESS and READ/WRITE IN PROGRESS FOR 
SECTOR nnnn (where nnnn is the first sector of a group of seven sectors being 
processed). 
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Line 

1 I/O CONFIGURATION PROGRAM 

2 READ lOCDS FROM THE PROCESSOR CONTROLLER FILE 
3 

4 ENTER REQUIRED INFORMATION: 

5 lOCDS TO BE READ (0,1,A0-A3,B0-B3) ==> 

6 

7 
8 
9 lOCDS READ/WRITE STATUS: 

10 NO READ/WRITE IN PROGRESS. see text 

11 READ/WRITE IN PROGRESS FOR SECTOR nnnn 
12 

13 
14 
15 
16 
17 
18 
19 

20 END RESHOW 

21 MENU 

22 system status 

23 message line 

24 command line 



Figure 4-20. Read lOCDS from the Processor Controller File Screen 
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Write lOCDS to the Processor Controller File 

The screen shown in Figure 4-21 appears when you enter menu number 8 on the 
primary menu (Figure 4-4) or enter the WRITE screen command. 

You use this menu to write the lOCDS in storage to one or more lOCDS(s) in the 
processor controller. The new configuration can become the active lOCDS if it is 
selected on a following power-on reset or on the next SYSIML CLEAR. 

If you do not want to write the lOCDS in storage to any lOCDS at this time, key in 
N on hne 5 and press ENTER. N returns you to the primary menu. (Use N to exit 
from this frame after reviewing/altering MSGl and/or MSG2 without writing the 
lOCDS to the processor controller.) 

On Une 5, key in the level of the lOCDS to which you want lOCP to write the 
lOCDS in storage. The valid entries depend on the number of I/O configuration 
data sets that your processor complex supports: 

• For two I/O configuration data sets, the vahd entries are Y, Al, and N. 

• For four I/O configuration data sets, the vaUd entries on the A side are Y, N, 
AO, Al, A2, and A3; on the B side they are N, BO, Bl, B2, and B3. 

• For eight I/O configuration data sets, all of the entries are vahd for a 3084 
Processor Complex operating in MP mode. In addition, you can specify ABx 
(where x is 0, 1,2, or 3) to write the lOCDS in storage to the specified lOCDS 
on both side A and side B. 

Notes: 

1. Specifying Y is the same as specifying Al . 

2. If your processor complex has only a LVLO and LVLl lOCDS, lOCP writes the 
lOCDS from storage to the LVLl lOCDS. Test the new configuration in the 
LVLl lOCDS; then switch the LVLl lOCDS with the LVLO lOCDS. 

On lines 6 and 7, respectively, lOCP displays the time and date that will be used to 
time stamp the lOCDS when it is written to the processor controller. (The time 
stamp will be used on the lOCP configuration reports of this lOCDS to indicate 
when it was written.) The time and date displayed are either zeroes or values you 
provided on a previous menu screen. You can change these values: on line 6, key in 
the hour and minute values; on Hne 7, key in the year and day values. (Note that 
the time and date entries you make do not activate the time-of-day clock.) 

If you want to write to an lOCDS that is write-protected, you must first remove the 
write-protection using the lOCDSM (SYS021) frame. Then press ENTER to write 
the lOCDS in storage to an lOCDS in the processor controller. 

On line 11, lOCP displays the status of the write operation. After you press ENTER 
and lOCP begins write processing, the text on line 1 1 varies between NO 
READ/WRITE IN PROGRESS and READ/WRITE IN PROGRESS FOR 
SECTOR nnnn (where nnnn is the first sector of a group of seven sectors being 
processed). 
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On line 15, lOCP displays the contents of MSGl. This information appears on the 
IDl line in the heading of the configuration reports. Bytes 1 through 8 are also the 
source of the customer name (dsname) for the lOCDS that appears on the lOCDSM 
(SYS021) frame. On hne 16, lOCP displays the contents of MSG2. This 
information appears on the ID2 Hne in the heading of the configuration reports. 
MSGl and MSG2 can be modified before writing the lOCDS to the processor 
controller. 

Any alphabetic characters entered will appear in upper case in the display even if the 
user entered those characters in lower case. 

Note: If you write a new lOCDS to the processor controller, there might be an 
inconsistency between the system configuration created by a system generation and 
the I/O configuration in the new lOCDS. 



Line 

1 

2 

3 

4 

5 

6 

7 

8 

9 

IG 
11 
12 
13 
14 
15 
16 
17 
18 
19 
2G 
21 
22 
23 
24 



I/O CONFIGURATION PROGRAM 
WRITE lOCDS TO THE PROCESSOR CONTROLLER FILE 

ENTER REQUIRED INFORMATION: 

WRITE lOCDS (Y,N,AO-A3,B0-B3,ABO-AB3) ==> 

TIME (HOUR. MINUTE) (HH.MM) ==> 



DATE (YEAR. DAY (JULIAN)). 



.(YY.DDD) 



lOCDS READ/WRITE STATUS: 

NO READ/WRITE IN PROGRESS. 

READ/WRITE IN PROGRESS FOR SECTOR nnnn 



see text 



ENTER CHANGES FOR MSGl AND/OR MSG2: 

NOTE: -DSNAME- IS THE FIRST EIGHT BYTES OF MSGl. 
MSGl ==> 
MSG2 ==> 



END 
MENU 



RESHOW 



system status 
message line 
command line 



Figure 4-21. Write lOCDS to the Processor Controller File Screen 
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End lOCP 



The screen shown in Figure 4-22 appears when you enter END on line 24 of a menu 
screen and the lOCDS in storage has been generated or modified but has not been 
written to any lOCDS in the processor controller. 

You use this menu to terminate lOCP and confirm the destruction of the lOCDS in 
storage (END), continue lOCP operation (MENU), or select the write lOCDS to the 
processor controller file menu (WRITE). 

On Une 24, key in END, MENU, or WRITE. 

Press ENTER. 

If you keyed in END and the audible alarm sounds, put the console into FDC 
mode. Then type RSTALM on the command Une and press ENTER to reset the 
alarm. " 



Line 

1 

2 

3 

4 

5 

6 

7 

8 

9 
IG 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



I/O CONFIGURATION PROGRAM 
END lOCP 

*************************************** 

* ATTENTION: THE lOCDS IN STORAGE HAS * 

* BEEN MODIFIED OR GENERATED BUT NOT * 

* WRITTEN TO THE PROCESSOR CONTROLLER * 

* piLE^ * 

*************************************** 

SELECT COMMAND AND ENTER ON BOTTOM LINE: 

_ TO DESTROY THE lOCDS IN STORAGE, ENTER END. 
_ TO CONTINUE WITH lOCP OPERATION, ENTER MENU. 
TO BRING UP THE WRITE lOCDS MENU, ENTER WRITE. 



END 
MENU 



RESHOW 
WRITE 



system status 
message line 
command 1 i ne 



Figure 4-22. End lOCP Screen 
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Methods of Executing the Stand-Alone Version of lOCP 

This topic suggests steps that can be used to execute the stand-alone version of lOCP 
in order to (1) generate an lOCDS during the installation of a new processor 
complex by the customer engineer (CE), and (2) replace an lOCDS by using 
card-image input on an existing processor complex. 

Generating an lOCDS on a New Processor Complex 

Note: The steps in this example are performed by the customer engineer (CE) as 
part of the installation procedure for a processor complex. This example assumes 
that the installation has previously prepared the card-image input macro instructions 
for use by the CE. This input deck should define the initial I/O configuration for 
the new processor complex and can consist of lOCP macro instructions only or 
lOCP macro instructions combined with MVS system generation macro instructions. 

During the installation of a new processor complex, the CE needs to create at least a 
minimum lOCDS before generating the complete lOCDS from card-image input 
macro instructions. This minimum lOCDS consists of an input device (card reader 
or magnetic tape) to read the installation-prepared input macro instructions and an 
output printer to receive messages and reports. (You can execute lOCP without an 
output printer; however, all lOCP messages and reports are lost.) 

By using the appropriate console commands and lOCP menus, the CE follows these 
steps to generate an lOCDS for the new processor complex. 

1. Determine the addresses and characteristics of the installed channel path(s), 
control unit(s), and I/O devices to be used as the input and output devices 
needed for the minimum lOCDS. 

Note: The starter configuration (shipped as an lOCDS in the processor 
controller) might have defined the needed devices, in which case Steps 2 through 
7 can be skipped. Compare the configuration reports provided for the starter 
configuration with the physically installed devices. 

2. Start lOCP from the system console or the service support console. When you 
start lOCP, lOCP initiahzes a null lOCDS in storage. 

3. Add the definidons of the channel path(s), control unit(s), and I/O devices 
needed to read the input deck and print messages and reports. (See Figure 4-6, 
Figure 4-10, Figure 4-13, and Figure 4-16.) 

4. Display the channel path(s), control unit(s), and I/O devices you added in Step 3 
to ensure they are correctly defined. (See Figure 4-5, Figure 4-9, Figure 4-12, 
and Figure 4-15.) 

5. Write the lOCDS in storage to one or more lOCDS(s) in the processor 
controller. (See Figure 4-21.) 

6. End lOCP. (See Figure 4-22.) 

7. Perform a power-on reset of the system with the appropriate lOCDS as the 
source of the configuration data to be used by the channel subsystem. Use the 
lOCDSM (SYS021) frame to select the lOCDS and the CONFIG (SYS020) 
frame to perform the power-on reset. The channel subsystem can now perform 
I/O requests to the needed input and output devices. 

8. Prepare the input device with the installation-prepared input deck. 

9. Prepare the output printer. Note that the printer buffer must have been 
previously initiahzed before lOCP can print to it. 
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10. start lOCP. 

11. Build an lOCDS from card-image input. (See Figure 4-18.) If the input deck 
contains MVS system generation macro instructions, use the IGNORE = Y 
option on the build lOCDS from cards menu. (For more details, see "Steps 
lOCP Performs to Build an lOCDS", in this chapter.) 

12. Analyze the configuration reports produced in Step 11 to ensure that the 
generated lOCDS in storage matches the installation's I/O configuration plan. 
If it does not, consult with the installation's system programmer. 

13. Write the lOCDS generated in storage in Step II to one or more lOCDS(s) in 
the processor controller. (See Figure 4-21.) 

14. EndlOCP. 

15. If your processor complex only has a level AO and Al (LVLO and LVLl) 
lOCDS, switch the the data sets after the new I/O configuration has been tested. 
To switch data sets, use action 3 (SWITCH DS A/B) on the CONFIG (SYS020) 

■ frame. The AO lOCDS now contains the installation's initial lOCDS. The Al 
lOCDS contains the starter configuration. 

16. Perform a power-on reset of the system and use the appropriate lOCDS as the 
source of configuration data. 

17. Start lOCP. 

18. Read the active lOCDS into storage. (See Figure 4-20.) 

19. Produce reports of the lOCDS in storage. (See Figure 4-19.) These 
configuration reports represent the active I/O configuration for the processor 
complex. 

20. Return the input deck to the installation's system programmer. The deck is used 
by the installation on subsequent definitions of an lOCDS based on changes to 
the I/O configuration. 

21. EndlOCP. 

22. Continue with the installation of the new processor complex. This includes 
testing the I/O subsystem using the I/O configuration defined by the installation. 

Replacing an lOCDS by Using Card-Image Input 

This example describes the steps the installation can use to replace the I/O 
configuration data in an lOCDS on an installed processor complex. (For an MVS 
system, you can also use the MVS version of lOCP. See "Subsequent Definition and 
Replacement of I/O Configuration Data" in Chapter 2 for the required steps. For a 
VM/SP, VM/SP HPO, or VM/XA Systems FaciHty system, you can also use the VM 
version of lOCP. See "Subsequent Definition and Replacement of I/O 
Configuration Data" in Chapter 3 for the required steps.) The following procedure 
describes how to use the stand-alone version of lOCP to change the I/O 
configuration for your processor complex. 

1 . Update your input deck to reflect the new I/O configuration for your processor 
complex. This deck can consist of lOCP macro instructions only or lOCP 
macro instructions combined with MVS system generation macro instructions. 

2. Start lOCP from the system console. 

3. Prepare the input device with the new input deck. 

4. Prepare the printer. The printer must be initialized (the forms and print buffer 
must be loaded). 
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5. On the primary menu (Figure 4-4), enter menu number 5 to select the build 
lOCDS from cards menu (Figure 4-18). 

6. Key in the appropriate data and press ENTER. 

lOCP reads, checks the syntax, and vahdates the input macro instructions; it 
generates an lOCDS in storage; and it produces configuration reports of the 
lOCDS generated in storage. (For more details, see "Steps lOCP Performs to 
Build An lOCDS" in this chapter.) 

7. Analyze the configuration reports produced in Step 6 to ensure that the desired 
I/O configuration has been generated. 

8. If the input deck needs to be changed: end lOCP, modify the input deck, and 
start again at Step 2. 

9. If the input deck is correct: return to the primary menu, select the write lOCDS 
to the processor controller file menu (Figure 4-21), and write the generated 
lOCDS to the level xx lOCDS in the processor controller. 

10. End lOCP. 

The I/O configuration data in the level xx lOCDS now contains your new 
configuration. On a following power-on reset, you activate this new 
configuration by selecting the level xx lOCDS as the source of the configuration 
data the channel subsystem uses to control I/O requests. Use the lOCDSM 
(SYS021) frame to select the lOCDS and the CONFIG (SYS020) frame to 
perform a power-on reset. 

1 1 . Test the new configuration following the procedures established for your 
installation. 

12. If your processor complex has only a level AO and Al (LVLO and LVLl) 
lOCDS, switch the data sets after the new I/O configuration has been tested. To 
switch data sets, use action 3 (SWITCH DS A/B) on the CONFIG (SYS020) 
frame. This action places the new I/O configuration in the AO lOCDS. (The Al 
lOCDS contains the configuration previously defined in the AO lOCDS.) Before 
the next power-on reset, specify the AO lOCDS as the source of configuration 
data for the channel subsystem. 

13. Save the card-image input used in Step 5 to provide a backup. 

Notes: 

1 . For an MVS system, if you change the hardware configuration with the 
stand-alone version of lOCP, execute an MVS system generation with an input 
deck modified to reflect the changes. This action ensures consistency between 
the software and hardware configurations. 

2. For a VM/SP, VM/SP HPO, or VM/XA Systems Facility system, if you change 
the hardware configuration with the stand-alone version of lOCP, modify the 
real I/O configuration file and re-generate your operating system. This action 
ensures consistency between the software and hardware configurations. (The real 
I/O configuration file for VM/SP and VM/SP HPO is DMKRIO; for the 
VM/XA Systems Facility, it is HCPRIO.) 
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steps lOCP Performs to Build an lOCDS 

lOCP performs the following steps when you specify that you want to generate an 
lOCDS. 

Note: Steps 1 through 5 are repeated for each input macro instruction as it is read 
(unless an error is found as indicated in Steps 3 and 4). 

lOCP: 

1. Reads each macro instruction from the input device. 

2. Prints each macro instruction on the output printer. 

3. Checks the syntax of each macro instruction for correct format. If a syntax 
error is found (such as a missing parenthesis), lOCP prints an error message on 
the output printer following the macro instruction that contains the error. lOCP 
stops checking the syntax of a macro instruction when it encounters the first 
syntax error on that macro instruction. Therefore, if there are two or more 
syntax errors on a single macro instruction, the second and following errors are 
found on subsequent runs of lOCP. 

If lOCP finds an error in Step 3, lOCP returns to Step 1 and continues reading, 
printing, and checking the syntax of the following macro instructions, but does 
not perform any of the following steps. 

4. Checks the validity of each macro instruction. For example, lOCP checks that a 
CNTLUNIT macro instruction has specified a channel path that has been 
previously defined on a CHPID macro instruction. If an error is found, lOCP 
prints an error message on the output printer following the macro instruction 
that contains the error. 

If lOCP finds an error in Step 4, lOCP returns to Step 1 and performs only 
Steps 1 through 3 for the remainder of the macro instructions. Therefore, if 
there are two or more validity errors in your input deck, the second and 
following errors are found on subsequent runs of lOCP. 

5. Builds the appropriate identification, channel path, control unit, or I/O device 
record and enters the record into the lOCDS in storage. 

If more macro instructions remain to be read, lOCP returns to Step 1 . 

After all of the input macro instructions have been processed and all of the records 
entered into the lOCDS in storage, lOCP performs Step 6. 

6. Generates the lOCDS in storage and makes additional checks. For example, 
lOCP checks that the channel numbers within a channel set are consecutive. If 
lOCP finds an error, lOCP issues an error message and waits for the next 
command. 

After lOCP has successfully generated an lOCDS in storage, lOCP performs Step 7. 

7. Produces the lOCP configuration reports of the lOCDS generated in storage. 

After checking the configuration reports to ensure that the correct configuration 
was generated, you can write the lOCDS generated in storage to one or more 
lOCDS(s) in the processor controller. (See Figure 4-21.) 
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Dumping lOCP Storage 



To help you debug lOCP problems, the stand-alone version of lOCP provides a 
dump function that allows you to dump the lOCP storage area (including the 
lOCDS in storage) to a printer or tape drive. Note that the dump routine has no 
I/O recovery procedures. 

To invoke the dump function, perform the following steps: 

1. Prepare the output device: 

• If the output device is a printer, make the printer ready. (lOCP uses 
LRECL=i20) 

• If the output device is a tape drive: mount an unlabeled tape, rewind the 
tape to the load point, and make the tape drive ready. (lOCP uses 
LRECL= 121 and RECFM = FA.) 

Note that the output device must be defined in the I/O configuration that was 
processed on the previous power-on reset or SYSIML CLEAR and must be 
available to the processor you are using to execute lOCP. While executing 
lOCP, assign exclusively to lOCP any devices and control units that lOCP uses. 
(Other systems should not share the devices and control units.) 

2. With the console in frame dependent command (FDC) mode, key in SYSRESET 
and press ENTER. (To put the console in FDC mode: key in FDC, press and 
hold down the ALT key, and press the CMD key while holding down the ALT 
key.) 

3. Key in F ALTCPn (or F CP-n20). 

Replace n with the processor you are using to execute lOCP: enter 0, 1,2, or 3. 
Press ENTER. 

4. When system frame ALTCPn (CP-n20) is displayed, key in an appropriate 
option as indicated on the frame, and press ENTER to display the floating point 
registers. 

Alter floating point register as follows: 

• If the output device is a printer, set the three rightmost hexadecimal digits to 
the device address/number of the printer. Set all other digits to 0. 

• If the output device is a tape drive, set the three rightmost hexadecimal 
digits to the device address/number of the tape drive. Set the two leftmost 
hexadecimal digits to the hexadecimal value of the tape mode set command. 
(To use reset mode, use a value of 03.) Set all other digits to 0. 

Press ENTER. Ensure that the contents of the register were correctly altered. 

5. Key in an appropriate option as indicated on the frame, and press ENTER to 
display the current PSW. 

Alter the PSW to: OOOCOOOOOOOOOFFC. 

Press ENTER. Ensure that the contents of the PSW were correctly altered. 

6. Key in START CPn. 

Replace n with the processor you are using to execute lOCP: enter 0, I, 2, or 3. 

Press ENTER. A dump is taken of the lOCP storage area and lOCDS in 
storage. 
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When the dump has completed, lOCP loads a disabled PSW with a wait state code 
of B20 and issues message ICP515W to the console. If the audible alarm sounds 
when lOCP enters the disabled wait state, type RSTALM on the bottom line and 
press ENTER to reset the alarm. 

In 370-XA mode, a wait state code of B23 occurs if lOCP was unable to match the 
device number in floating point register with a subchannel information block. You 
must enter a device number in floating point register that is defined in the active 
lOCDS (the lOCDS used in the previous power-on reset or SYSIML CLEAR). 
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lOCP Wait State Codes 



Enabled Wait States 

During execution of the stand-alone version of lOCP, the processor enters many 
enabled (PSW Bit 7 is on) wait states. These are normal conditions while lOCP 
waits for the processor controller to respond to lOCP requests such as a read or 
write to a console or lOCDS. If the processor stays in an enabled wait state, other 
than waiting for operator input on a console, for an extended period of time (1-3 
minutes), the processor controller is busy. The user may either wait for the 
processor controller to finish or put the console in to FDC mode, do a SYSRESET 
to the processor running lOCP and restart lOCP at a later time. If the problem 
persists take an lOCP dump and contact IBM for programming support. 

Disabled Wait States 

During execution of the stand-alone version of lOCP, lOCP issues the following wait 
state codes when the indicated conditions occur. (Note that the MVS and VM 
versions of lOCP do not issue wait state codes.) 

If the audible alarm sounds when lOCP enters the disabled wait state, put the 
console into FDC mode (if it isn't already). Then type RSTALM on the bottom line 
and press ENTER to reset the alarm. 



B20 

Explanation: The console operator who is 
executing the stand-alone version of lOCP has 
ended lOCP processing, or the lOCP dump 
function has been completed. 

Operator Response: None. 

B21 

Explanation: A program check interruption has 
occurred during execution of the stand-alone 
version of lOCP. 



Operator Response: 

programmer. 



Notify your system 



Problem Determination: Save all associated output. 
Take an lOCP dump. Contact IBM for 
programming support. 

B22 

Explanation: A machine check interruption has 
occurred during execution of the stand-alone 
version of lOCP. 

Operator Response: Notify your system 
programmer. 

Problem Determination: Save all associated output. 
Contact IBM for hardware support. 



B23 

Explanation: (1) An uncorrectable I/O error has 
occurred during execution of the stand-alone 
version of lOCP. (2) The user requested a dump of 
lOCP storage in 370-XA mode, but lOCP was 
unable to find a subchannel information block for 
the device number entered in floating point register 
0. 

Operator Response: (1) Notify your system 
programmer. (2) Enter the correct device number 
in floating point register and try the lOCP dump 
procedure again. 

Problem Determination: (1) Save all associated 
output. Take an lOCP dump. Contact IBM for 
hardware support. (2) None. 

B24 

Explanation: During execution of the stand-alone 
version of lOCP, lOCP has encountered an error in 
the processor controller and cannot communicate 
with the person operating lOCP. 



Operator Response: 

programmer. 



Notify your system 



Problem Determination: Save all associated output. 
Take an lOCP dump. Contact IBM for hardware 
support. 
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Chapter 5. lOCP Configuration Reports 



This chapter describes the lOCP configuration reports. You use the reports to check 
the I/O configuration data in an lOCDS. Following is a brief description of each 
configuration report with references to report examples: 

• The channel path identifier (CHPID) summary report Hsts the channel path 
identifiers defined in the lOCDS. For each channel path identifier, the report 
shows the corresponding channel number, the channel set, and the mode of I/O 
operation. Figure 5-1 is an example of the CHPID summary report. 

If you do not enter a 370 channel number and channel set, N/A appears in those 
columns in the report. 

• The I/O device report lists, by 370-XA device number, the I/O devices defined in 
the lOCDS. The report shows the siae (side A if the chpid is less than 40, 
otherwise side B), control units, and channel path identifiers to which each 
device is assigned. The report also provides other information, such as 
subchannel assignment (shared, shared block, or nonshared subchannel.) 
Figure 5-2 consists of pages from an I/O device report. 

If you do not enter a 370 channel number (370 CHANNEL ADDR on the 
report) and channel set, N/A appears in those columns in the report. If a 
370/370-XA lOCP reads a 370 lOCDS, N/A appears in the report under 370-XA 
SUB-CHAN NUMBER and 370-XA LOG CNTL UNIT NUMBER. 

If applicable, the I/O device report lists warning message ICP054I (the I/O 
device is not connected to the specified primary channel address). 

• The logical control unit report Usts the 370-XA logical control units in the 
lOCDS by logical control unit number. For each logical control unit, the report 
lists the rotation order for 370-XA mode (under DEVICE CHPID ORDER). 
For each device in a logical control unit, the report shows the device number, 
the attaching control units, and the preferred channel path. Figure 5-3 consists 
of pages from the logical control unit report. 

Note; Logical control units with no devices are listed at the end of the logical 
control unit report. The user should verify that the logical control unit report 
accurately describes the user's configuration. 

A logical control unit report is not produced if lOCP (370 or 370/370-XA) reads 
and prints a 370 lOCDS, or if the lOCDS in storage contains an error. 

If you operate your system only in 370 mode, you can disregard the logical 
control unit report. 

• The channel path identifier (CHPID) report, like the CHPID summary report, 
lists the channel path identifiers defined in the lOCDS. In addition to the 
information given in the CHPID summary report (Figure 5-1), the CHPID 
report shows the side the channel path is assigned to for 370 mode, and the 
control units and I/O devices assigned to each channel path. It also provides 
other information, such as the interface protocol (D. C. interlock or data 
streaming) used by the control unit(s) attached to the channel path. Figure 5-4 
consists of pages from the channel path identifier report. 

If you do not enter a 370 channel number and channel set, N/A appears in those 
columns in the report. If a 370/370-XA lOCP reads and prints a 370 lOCDS, 
N/A appears in the report under 370-XA LOG CNTL UNIT NUMBER. 
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Notes: ■ 

1. A 370 level lOCP cannot read a 370/370-XA lOCDS. (lOCP issues error 
message ICP404I and does not print reports.) 

2. The Device Configuration Frame (DEVCXA) provides real-time device 
configuration data for 370-XA mode operation. For each subchannel number, 
the DEVCXA fi'ame displays the corresponding device number, unit address, 
and attaching channel path identifiers. You can minimize requesting lOCP 
configuration reports by using the DEVCXA fi*ame. 

Conditions for Producing Reports 

If no error occurs, the MVS version of lOCP produces reports when: 

• lOCP generates an lOCDS. The reports show the configuration data in the 
lOCDS that is generated in storage based on the input macro instructions. 

• You code the REPORT option on the PARM parameter of the EXEC 
statement. The reports show the configuration data contained in each lOCDS 
that you specified on REPORT == . 

If no error occurs, the VM version of lOCP produces reports when: 

• lOCP generates an lOCDS in response to the CMS lOCP command with 
lOCDS generation options. The reports show the configuration data in the 
lOCDS that lOCP generates in storage from the input macro instructions. 

• You use configuration report options (BOTHRPT, CDORPT, CDIRPT, 
RPTAx, RPTBx, RPTA, or RPTB) on the CMS lOCP command. The reports 
show the configuration data contained in each specified lOCDS. 

If no error occurs, the stand-alone version of lOCP produces reports, when 

• You use the build lOCDS from cards menu (Figure 4-18). The reports show the 
configuration data in the lOCDS that is generated in storage based on the input 
macro instructions. 

• You use the print lOCDS configuration reports menu (Figure 4-19). The 
reports show the configuration data contained in the lOCDS in storage. In this 
case, the configuration data represents one of the following: 

— The lOCDS that has been previously read into storage using the read from 
the processor controller file menu (Figure 4-20) 

— The lOCDS that has been previously generated in storage from card-image 
input using the build lOCDS from cards menu (Figure 4-18) 

— The lOCDS in storage after starting lOCP and adding configuration data to 
the null lOCDS from the console screen 

Note: If the lOCDS in storage contains an error and you use the print lOCDS 
configuration reports menu, lOCP produces the reports (except the logical 
control unit report), followed by the appropriate error message describing the 
first detected error (such as one of the messages ICP300I through ICP307I). In 
addition, if the lOCDS in storage contains an error, N/A appears in the reports 
for the subchannel numbers and the logical control unit numbers. 
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Configuration Report Headings 

There are four heading lines for each configuration report. The first hne of the 
heading shows: 

• The time and date lOCP produced the reports' 

• The lOCP version and level number. The versions are: 

- Version I is a 370 lOCP. 

- Version 2 is a 370/370-XA lOCP that supports only the LVLO and LVLl 
lOCDS. 

- Version 3 is a 37()/370-XA lOCP that supports four I/O configuration data 
sets on each side of the processor complex 

• The type of configuration report (CHPID, DEVICE, LOGICAL CONTROL 
UNIT, or CHANNEL PATH ID) 

• The report page number 

The second line of the heading shows: 

• The report's source, which can be card input, an lOCDS from a processor 
controller, or screen input 

• Whether the lOCDS in storage was modified by screen input. YES indicates 
that either the lOCDS was originally created from screen input or was modified 
by screen input after being generated from card input. NO indicates the lOCDS 
was generated from card input and was not modified by screen input. 

• When the report source is an lOCDS from a processor controller, if it is the 
active lOCDS: where YES indicates the data set was the active data set at the 
last power-on reset or SYSIML CLEAR, NO indicates the data set was not 
active at the last power-on reset or SYSIML CLEAR, and NA indicates not 
apphcable (for a report source of card or screen input) 

• When the report source is the active lOCDS, if it was updated: where YES 
indicates the active data set was updated (written to) after the last power-on 
reset or SYSIML CLEAR, NO indicates the active data set was not updated 
(not written to) after the last power-on reset or SYSIML CLEAR, and NA 
indicates not applicable (for a report source of card or screen input) 

The third hne of the heading (IDl =) shows: 

• Any identification information that you specified on the ID macro instruction. 
(Bytes 1 through 8 of IDl = are the same as the customer name of the lOCDS 
that appears on the lOCDSM (SYS021) frame.) 

• When the report source is an lOCDS from a processor controller, the time and 
date lOCP last wrote the lOCDS from storage to the processor controller.^ 



1 The MYS and VM versions of IOC? take the time and date from the operating system; the stand-alone version 
takes the time and date entered on the menu screens. 

2 The MYS and YM versions of IOC? take the time and date from the operating system; the stand-alone version 
takes the time and date entered on the menu screens. 
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The fourth line of the heading (ID2 = ) shows: 

• When the report source is an lOCDS from the processor controller, the 
processor controller time stamp.^ (The processor controller time stamp also 
appears on the lOCDSM (SYS021) frame.) 

• Any additional identification information that you specified on the ID macro 
instruction. 

Note: Figure 5-2, Figure 5-3, and Figure 5-4 contain only representative pages 
from the configuration reports; they do not show every page of every report. 



3 Time stamp information appears if the lOCDS was timestamped when the lOCDS was written to the processor 
controller. 
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370-XA 




370-XA 


370-XA LOG. 370-XA 
















370 


370 


DEVICE 


UNIT 


SUB-CHAN 


CNTL UNIT CNTL UNIT 


DEVICE 


CNTL UNIT 




CHAN PATH IDS 




CHANNEL 


SUB-CHAN 


NUMBER 


ADDR 


NUMBER 


NUMBER TYPE 


TYPE 


MODEL TIMEOUT NUMBER 




PROTOCOL 


1 II 1 1 


SIDE 


SET 


ADDR 


ASSIGNED 


BED 


BD 


129 


IC 2 


3330V 


YES OBO 
OBI 




DCI 


23 
16 
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A 



1 


BBD 
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UNSHARED 
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BE 


12A 
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17 
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B SIDE 


370 MODE-- 


DEVICE CONTROL BLOCKS- 


0017 SET 


0, 0017 SET 1 (INCLUDES 
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DUMMIES/SET) 












370-XA 


MODE--0301 


DEVICES, 03 DUMMY DEVICES, 030 


LOGICAL CONTROL UNITS, 
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PHYSICAL 


CONTROL UNITS 
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lOCP VERSION 3 


LEVEL 2 


LOGICAL CONTROL UNIT REPORT 


PAGE 


001 






REPORT 


SOURCE IS LVL 


Al lOCDS, MODIFIED BY SCREEN 


INPUT=NO, ACTIVE=NO, UPDATED=NO 






ID1=PRACTICE lOCP GENERATION 










WRITTEN 


TO 


PROCESSOR CONTROLLER ON: TIME 


14.50 DATE 85 


246 


ID2 = SAriPLE CONFIGURATION 


WITH 


THREE BYTE 


CHANNELS 




PROCESSOR CONTROLLER TIMESTAMP: TIME 


14.50 DATE 85 


246 


370-XA LOG. DEVICE 










ATTACHING 




ATTACHING 






CONTROL UNIT CHPID ORDER 
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PREFERRED 


CNTL UNIT 




CHPIDS 
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_l_ 


l_l 
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l_l_l_l_l 
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NONE 


001 




00 






01 00 
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NONE 
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084 
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OAC 


NONE 
NONE 
NONE 
HONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 
NONE 


004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 
004 




00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 




i 







I 



in 

I 

I— * 
o 



o 
n 

-0 



O 

n 

PC 

3 

pa 









to 

o 



r 
o 

TO 



n 

o 

3 



c 

3_ 

o 



TIME 14.52 DATE 85.246 

370-XA LOG. DEVICE 

CONTROL UNIT CHPID ORDER 
NUMBER I I I i I 



PAGE 002 







ATTACHING 


ATTACHING 


DEVICE 


PREFERRED 


CNTL UNIT 


CHPIDS 


NUMBER 


CHPID 


NUMBER 


l_l_l_l_l 


OAD 


NONE 


004 


00 


OAE 


NONE 


004 


00 


OAF 


NONE 


004 


00 


0B2 


NONE 
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00 


0B3 


NONE 
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370-XA LOG. DEVICE 






ATTACHING 


ATTACHING 




CONTROL UNIT CHPID ORDER 


DEVICE 


PREFERRED 


CNTL UNIT 
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NUMBER 1 1 1 1 1 
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lOCP VERSION 3 LEVEL 2 CHANNEL PATH ID REPORT 

REPORT SOURCE IS LVL Al lOCDS, MODIFIED BY SCREEN INPUT=NO. ACTIVE=NO, UPDATED=NO 
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ID1=PRACTICE lOCP GENERATION 

ID2=SAMPLE CONFIGURATION WITH THREE BYTE CHANNELS 



WRITTEN TO PROCESSOR CONTROLLER ON: TIME 14.50 DATE 85.246 
PROCESSOR CONTROLLER TIMESTAMP: TIME 14.50 DATE 85.246 
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CHPID 
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CONTROL UNIT 
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022 3830 
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26 3 1 A BLOCK 
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240 


40 


3350 
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262 


62 


3350 
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Chapter 6. lOCP Messages 



This chapter describes the lOCP messages for both: 

• ICP prefix 

• DMSICP prefix 



lOCP Messages (ICP Prefix) 



This section describes the messages produced by all versions of lOCP. The messages 
are described in alphanumeric order by message identifier and include, for each 
message: 

• The module that detects the need for the message (detecting module) 

• The module that issues the message or calls the message module (issuing module) 

• The module that contains the message text (containing module) 

Message ICP050D is sent to the MVS system operator's console and requests action 
by the system operator. The operator later receives either message ICP0506I or 
ICP0507I to indicate whether the lOCP job was successful or failed. All other 
messages are sent to the output printer for the lOCP programmer (running the MVS 
or VM version of lOCP) and/or the console screen for the lOCP operator (running 
the stand-alone version of lOCP). 

The message format is: 



ICPnnns text 



where: 

nnn is the message serial number. 

s is the type code: 

A Action; the operator must perform a specific action 

D Decision; the operator must choose an alternative 

1 Information; no operator action is required 

W Wait; processing stops until an action is determined and performed 



text is the message text. 
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ICPOOOI UNDEFINED MESSAGE CODE. CODE = xxxxxxxx HEX 

Explanation: Message code xxxxxxxx has been generated by lOCP for which a 
message has not been defined. A logical error has occurred in lOCP. 

System Action: lOCP action is unpredictable. 

Programmer Response: Rerun the lOCP job. If the problem occurs again, save the 
console sheet and all associated output. Notify your system programmer. 

Detecting Module: ICPCMSG 

Issuing Module: ICPCMSG 

Containing Module: ICPCMSG 

ICP050D SHOULD jobname WRITE TO LEVEL xxx lOCDS? REPLY 'YES', 
'NO', OR 'CANCEL' 

Explanation: A job with name "jobname" is executing lOCP with a WRTCDS 
option other than NO on the PARM parameter of the EXEC statement. lOCP 
issues this message to request permission from the MVS system operator for the job 
to write to the level xxx lOCDS in the processor controller. 

Note: If two (or more) jobs are allowed to concurrently update (write to) the level 
xxx lOCDS, the outcome could be an lOCDS that is logically inconsistent with the 
input from any one job. Using this lOCDS at power-on reset or SYSIML CLEAR 
could produce undesirable results. 

System Action: An operator reply of 'YES' allows the job to continue executing 
and, if no errors are encountered, to replace the input/output configuration data in 
the level xxx lOCDS in the processor controller with the input/output configuration 
data generated by this job. The operator should use the lOCDSM frame to ensure 
the level xxx lOCDS is not write-protected. A reply of 'NO' allows the job to 
continue generating input/output configuration data in storage and to produce 
reports, but does not permit the job to replace the input/output configuration data in 
the level xxx lOCDS in the processor controller. A reply of 'CANCEL' terminates 
the job immediately with the system code X'222'. 

Operator Response: Contact your system programmer and respond as instructed. 

Programmer Response: Follow your installafion procedures and advise the operator. 

Detecting Module: ICPPCNTL 

Issuing Module: ICPPCNTL 

Containing Module: ICPPCNTL 

Routing Codes: 1 and 1 1 

Descriptor Code: 7 
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ICP051I lOCP TERMINATED. CODE = xx 

Explanation: lOCP has terminated for one of the following reasons: 
Code Description 

01 An unknown keyword value was found on the FARM parameter of the 
EXEC statement. (This code can result from an extra left parenthesis after 
the REPORT keyword.) 

02 A duplicate keyword was found on the PARM parameter of the EXEC 
statement. 

03 An unknown keyword was found on the PARM parameter of the EXEC 
statement. 

04 The keyword value on the LINECOUNT keyword on the PARM parameter 
of the EXEC statement was not within the allowed range. 

05 Conflicting keywords were found on the PARM parameter of the EXEC 
statement. 

06 An extra or missing comma was found on the PARM parameter of the EXEC 
statement. This code can result from unbalanced parentheses around the 
REPORT parameter(s). 

07 One or more errors were found in the input card-image macro instructions. 
See the listing for related error messages. 

08 An error was found while lOCP was generating the lOCDS in storage. See 
the listing for related error messages. 

09 The operator replied 'NO' to message ICP050D or the VM user did not have 
privilege class C. The level xxx lOCDS in the processor controller was not 
replaced. 

OA lOCP encountered an error while writing the LVLl lOCDS in the processor 
controller. See the listing for related error messages. 

OB lOCP encountered an error while reading the LVLO lOCDS from the 
processor controller. See the listing for related error messages. 

OC lOCP encountered an error while reading the LVLl lOCDS from the 
processor controller. See the listing for related error messages. 

10 A REPORT or WRTCDS option has been specified but ICPIOCP only reads 
or writes an lOCDS on a 308x processor. 

4x lOCP encountered an error while reading/writing the level Ax lOCDS (where 
X is 0, 1,2, or 3) from/to the processor controller. See the listing for related 
error messages. 

5x lOCP encountered an error while reading/writing the level Bx lOCDS (where 
X is 0, 1,2, or 3) from/to the processor controller. See the Hsting for related 
error messages. 

6x lOCP encountered an error while doing a dual write of the Ax and Bx 

lOCDS (where x is 0, 1,2, or 3) to the processor controller. See the Hsting 
for related error messages. 

System Action: If lOCP encountered an error while doing anything other than 
reading an lOCDS, it terminates with return code 8. If lOCP encountered an error 
while reading an lOCDS, it terminates the read operation for that lOCDS. 
However, lOCP will attempt to read each additional lOCDS that was specified 
before it terminates with return code 8. 
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Programmer Response: Ensure that the FARM parameter on the EXEC statement 
is coded correctly. For processor controller errors, save the output hstings and 
report the problem to the customer engineer. 

Detecting Module: 

ICPPCNTL detects codes 01 through 06, 09 and 10 

ICPCARDS detects code 07 

ICPCGNDS detects code 08 

ICPCRTNS detects codes OA, OB, OC, 4x, 5x, and 6x 
Issuing Module: ICPPCNTL 
Containing Module: ICPCMSG 

ICP052I DCB DID NOT OPEN - SYSIN DD STATEMENT MAY BE 
MISSING/INVALID 

Explanation: The DCB for the data set specified on the SYSIN DD statement did 
not open when lOCP issued the OPEN macro instruction. 

System Action: lOCP terminates. 

Programmer Response: Ensure that the DD statement for the SYSIN data set is 
vahd. 

Detecting Module: ICPCGET 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP054I **WARNING** THE ABOVE I/O DEVICE IS NOT CONNECTED 
TO THE SPECIFIED PRIMARY CHANNEL ADDRESS 

Explanation: lOCP has found an I/O device that is not assigned to its primary 
channel. (For example, a device with address 180 is not assigned to channel 1.) 
You define the primary channel address for a device on the ADDRESS parameter of 
the lODEVICE macro instruction by specifying the channel number that 
corresponds to the lowest numbered channel path to which the device is assigned. 

System Action: lOCP prints this warning message following the I/O device in 
question. lOCP continues processing. 

Programmer Response: Ensure that the I/O configuration is correctly defined. 

Detecting Module: ICPCRPT 

Issuing Module: ICPCRPT 

Containing Module: ICPCMSG 

ICP055I **WARNING** DEVICE NUMBER DOES NOT MATCH UNIT 
ADDRESS 

Explanation: The second and third digits of the device number (specified on the 
ADDRESS keyword) do not match the unit address specified on the UNITADD 
keyword of the lODEVICE macro instruction. 

System Action: lOCP prints this warning message following the I/O device in 
question. lOCP continues processing. 



6-4 lOCP User's Guide and Reference 



Programmer Response: Remember this difference if the device is used in 370 mode 
or if you are reviewing EREP reports. 

Detecting Module; ICPCRPT 

Issuing Module: ICPCRPT 

Containing Module: ICPCMSG 

ICP056I lOCP JOB jobname FAILED. DID NOT BUILD LEVEL xxx lOCDS. 

Explanation: A job with name "jobname" was executing lOCP with the 
WRTCDS = xxx option on the PARM parameter of the EXEC statement. lOCP 
issues this message to inform the MVS system operator (who previously responded 
to message ICP050D) that this job failed to build the level xxx lOCDS. 

System Action: lOCP terminates the job with return code 8. 

Operator Response: Tell your system programmer that the job failed. 

Programmer Response: Review the messages on the job hsting and take the 
necessary actions. 

Detecting Module: ICPPCNTL 

Issuing Module: ICPPCNTL 

Containing Module: ICPPCNTL 

Routing Codes: 2 and 1 1 

Descriptor Code: 6 

ICP057I lOCP JOB jobname SUCCESSFUL. LEVEL xxx lOCDS REPLACED. 

Explanation: A job with name "jobname" was executing lOCP with the 
WRTCDS = xxx option on the PARM parameter of the EXEC statement. lOCP 
issues this message to inform the MVS system operator (who previously granted 
permission to write the lOCDS in response to message ICP050D) that this job 
successfully replaced the level xxx lOCDS. 

System Action: lOCP terminates the job with return code or 4. 

Operator Response: Follow your installation procedures. 

Detecting Module: ICPPCNTL 

Issuing Module: ICPPCNTL 

Containing Module: ICPPCNTL 

Routing Codes: 2 and 1 1 

Descriptor Code: 6 

ICPIOOI SYMBOL IN NAME FIELD EXCEEDS 8 CHARACTERS AND/OR 
CONTAINS INVALID CHARACTERS 

Explanation: The symboUc name that appears in the name field contains more than 
8 characters and/or contains invalid characters. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the name field. 
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Detecting Module: ICPCARDS 
Issuing Module; ICPCARDS 
Containing Module: ICPCMSG 

ICPIOII OP CODE NOT FOUND ON FIRST OR ONLY CARD 

Explanation: The operation field (macro instruction name) was not found before 
column 72. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Check for format errors and correct the errors. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP102I UNSUPPORTED OP CODE 

Explanation: The operation field does not contain a valid lOCP macro instruction 
name. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Use a valid lOCP macro instruction name in the operation 
field, or set IGNORE == YES to ignore non-IOCP macro instruction names. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP103I **WARNING** ID STATEMENT IGNORED - OUT OF SEQUENCE 

Explanation: lOCP found an ID macro instruction after processing one or more 
other lOCP macro instructions. 

System Action: lOCP ignores the ID macro instruction that is out of sequence and 
continues processing. 

Programmer Response: Ensure that the ID macro instruction is the first lOCP 
macro instruction in the input. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP104I **WARNING** MORE THAN ONE ID STATEMENT - ONLY THE 
FIRST WAS USED 

Explanation: More than one ID macro instruction was found in the input macro 
instructions. Only one ID macro instruction can be specified. 

System Action: lOCP processes the first ID macro instruction, ignores any 
following ID macro instructions, and continues processing. 
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Programmer Response: Ensure that there is only one ID macro instruction in the 
input and that it is the first lOCP macro instruction. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP105I OPERAND FIELD NOT FOUND 

Explanation: The operand field was not found before column 72. On a 
continuation card, the operand field must start in column 16. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the operand field. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP106I NON-BLANK CHARACTER(S) FOUND IN COLUMNS 1-15 OF 
CONTINUATION CARD 

Explanation: A non-blank character was found in columns 1 to 15. On a 
continuation card, columns 1 to 15 must be blank and the operand field must start 
in column 16. (The preceding card had a non-blank character in column 72, 
indicating that this is a continuation card.) 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Ensure that the operand field on the continuation card starts 
in column 16. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP107I **WARNING** EXCEEDED THE ALLOWED NUMBER OF 
COMMENT CONTINUATION CARDS 

Explanation: More than two continuation cards were found for an lOCP comment 
card. 

System Action: lOCP prints the extra comment continuation cards and continues 
processing. 

Programmer Response: Restructure the comment so that it can be contained in a 
total of three comment cards, or code an asterisk in column 1 (or *IOCP in columns 
1 to 5) and remove the continuation characters in column 72 of the preceding 
card(s). 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 
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ICP108I UNEXPECTED END OF FILE ON SYSTEM INPUT (SYSIN) 

Explanation: A continuation card was expected when an end-of-file occurred on the 
input data set. The last card contains a non-blank character in column 72. 

System Action: lOCP does not generate an lOCDS in storage and does not produce 
conjfiguration reports. 

Programmer Response: Ensure that no macro instructions or comment cards are 
missing in the input. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP109I MISSING LEFT PARENTHESIS 

Explanation: A missing left parenthesis was detected. The parameter requires the 
keyword value field to be enclosed in parentheses. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICPllOI EXTRA LEFT PARENTHESES 

Explanation: The parameter requires 1 or 2 left parentheses to start the keyword 
value field. More than the required 1 or 2 were found. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICPini **WARNING** PATH INFORMATION DEFINED WITH ** IS 
EXCLUDED FROM lOCDS 

Explanation: The characters ** were detected instead of a chpid number on the 
PATH parameter. The ** indicate a channel used only by processors other than the 
processor complexes listed on the cover of this manual. 

System Action: lOCP prints this warning message following the CHPID macro 
instruction that contains **. lOCP does not include in the lOCDS the channel 
number and channel set following the characters **. Processing continues. 

Programmer Response: Ensure that the characters ** were specified for the intended 
channel number and channel set. 
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Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 

ICP112I DELIMITER ERROR, EXPECT BLANK OR COMMA 

Explanation: A character (such as a right parenthesis) was found where a blank or 
comma is required, or a keyword value contained too many digits. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter or the delimiter. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP113I DELIMITER ERROR, EXPECT COMMA OR RIGHT 
PARENTHESIS 

Explanation: A character (such as a blank) was found where a comma or right 
parenthesis is required. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter or the delimiter. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP114I INVALID DELIMITER, ONLY BLANK, COMMA OR RIGHT 
PARENTHESIS IS EXPECTED 

Explanation: A character other than a blank, comma, or right parenthesis was 
found where a valid delimiter is required, or a keyword value contained too many 
digits. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter and/or supply the correct ending 
delimiter. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 
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ICP115I DELIMITER ERROR, EXPECT RIGHT PARENTHESIS 

Explanation: A character (such as a blank or comma) was found where a right 
parenthesis is required, a keyword value contained too many digits, or too many 
keyword values were specified. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter and/or correct the invalid delimiter 
with a right parenthesis. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP116I DELIMITER ERROR, EXPECT LEFT PARENTHESIS 

Explanation: A character other than a left parenthesis was found where a left 
parenthesis is required. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Check for incorrect characters in the parameter and/or 
correct the delimiter. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP117I **WARNING** THE ABOVE DEVICE(S) EXCLUDED FROM 
lOCDS 

Explanation: The characters *** were detected as the keyword value for the 
CUNUMBR parameter. The *** indicate that the I/O device(s) are used only by 
processors other than the processor complexes listed on the cover of this manual. 

System Action: lOCP prints this warning message following the lODEVICE macro 
instruction that contains ***. lOCP does not include the device(s) in the lOCDS. 
Processing continues. 

Programmer Response: Ensure that the device(s) defined by the lODEVICE macro 
instruction are to be excluded from the lOCDS. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 
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ICP118I **WARNING** OPTCHAN SYNTAX/VALUE ERRORS DETECTED 

Explanation: The OPTCHAN parameter on the lODEVICE macro instruction 
contains one or more syntax or value errors. The possible errors are: 

• OPTCHAN keyword was specified more than once. 

• Invalid delimiter follows the keyword value. 

• Keyword value is not a hexadecimal digit or contains more than one 
hexadecimal digit. 

• Keyword value specifies an alternate channel that is not greater than the primary 
channel. 

System Action: lOCP prints this warning message following the lODEVICE macro 
instruction in question. Because of the error, lOCP does not attempt to vahdate 
that a path exists from the device(s) to the alternate channel specified by the 
OPTCHAN keyword, value. lOCP continues processing. 

Programmer Response: Ensure that the OPTCHAN parameter is correctly coded. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 

ICP119I BEGINNING APOSTROPHE NOT FOUND 

Explanation: The beginning apostrophe was not found in a parameter that requires 
the keyword value to be enclosed in apostrophes. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP120I ENDING APOSTROPHE NOT FOUND 

Explanation: The ending apostrophe was not found in a parameter that requires the 
keyword value to be enclosed in apostrophes. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the parameter. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 
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ICP121I OPERAND FIELD IS TOO LONG TO PROCESS 

Explanation: The length of the operand field is greater than the length lOCP can 
process for operand fields. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Check that the macro instruction and continuation cards are 
correctly specified. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP122I NOT ALL THE REQUIRED PARAMETERS WERE SPECIFIED 

Explanation: At least one of the required parameters was not found on the macro 
instruction. This message may indicate that a continuation character was missing 
from column 72. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Ensure that all required parameters are specified. Ensure 
that all continuafion characters are correctly specified. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP123I DUPLICATE KEYWORDS ON STATEMENT 

Explanation: A keyword parameter was found more than once on the macro 
instruction. Keyword parameters cannot be repeated on the same macro instruction. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Ensure that keyword parameters are not duplicated. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP124I TOO MANY KEYWORD VALUES SPECIFIED 

Explanation: More than the allowed number of keyword values were found on the 
parameter. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Ensure that the number of keyword values does not exceed 
the maximum allowed. 
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Detecting Module: ICPCARDS, ICPCARDX 
Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 

ICP125I PARAMETER CONTAINS NON-NUMERIC CHARACTERS 

Explanation: A character other than through 9 was found on a parameter for a 
keyword value that requires a decimal value. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP126I PARAMETER CONTAINS NON-HEXADECIMAL CHARACTERS 

Explanation: A character other than through 9 or A through F was found on a 
parameter for a keyword value that requires a hexadecimal value, or not enough 
digits were specified on a keyword value. (Note that the channel path identifier on 
the PATH parameter requires two digits.) 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP127I UNKNOWN OR DUPLICATE KEYWORD 

Explanation: An unknown keyword parameter was found on the macro instruction, 
or duphcate keyword parameters were specified. If a continuation card generates this 
message, a comma may be missing on the previous card. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the unknown or duplicate keyword parameter. If 
this is an lODEVICE macro instruction and the keyword is a valid system 
generation keyword, set the IGNORE = YES option so that lOCP will ignore 
non-IOCP parameters. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 
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ICP128I INVALID PROTOCL VALUE. MUST BE D, S OR S4 

Explanation: A character other than D, S or S4 was found as the keyword value on 
the PROTOCL parameter. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP129I INVALID SHARED VALUE. MUST BE Y OR N or YB 

Explanation: Character(s) other than Y or N or YB were found as the keyword 
value on the SHARED parameter. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP130I PATH PARAMETER - CHPID VALUE INVALID 

Explanation: A channel path identifier, found on the PATH parameter or entered 
from the console screen, is not within the range of valid channel paths. 

System Action: (1) If the input is from card-image macro instructions, lOCP 
continues to check the syntax of the remaining macro instructions but does not 
generate an lOCDS in storage and does not produce configuration reports. (2) If 
the input is from the console screen, the channel path is not added. 

Programmer Response: (1) For input from card-image macro instructions, correct 
the channel path identifier on the PATH parameter. (2) For input from the console 
screen, enter the correct channel path. 

Detecting Module: ICPCARDS, ICPCARDX 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP131I PATH PARAMETER - NO CHANNEL SPECIFIED 

Explanation: A required channel number was not found on the PATH parameter 
for its associated channel path. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Supply the missing channel number. 

Detecting Module: ICPCARDS 
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Issuing Module: ICPCARDS 
Containing Module: ICPCMSG 

ICP132I PATH PARAMETER - INVALID CHANNEL SET VALUE. MUST BE 
OOR 1 

Explanation: A character other than or 1 was found on the PATH parameter as a 
keyword value for the channel set. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the channel set value. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP133I INVALID TYPE VALUE. MUST BE BY OR BL 

Explanation: A keyword value other than BY or BL was found on the TYPE 
parameter. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDS 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP134I INVALID CONTROL UNIT NUMBER 

Explanation: A control unit number other than a hexadecimal value in the range of 
000 through 3FF was found on the CUNUMBR parameter or entered from the 
console screen. 

System Action: (1) If the input is from card-image input, lOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an lOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, the control unit is not added. 

Programmer Response: (1) For input from card-image macro instructions, correct 
the control unit number on the CUNUMBR parameter. (2) For input from the 
console screen, enter the correct control unit. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 
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ICP135I INVALID UNITADD NUMBER 

Explanation: On the UNITADD parameter, a keyword value for number was not 
within the allowable range of decimal 1 through 256. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP136I INVALID DEVICE ADDRESS NUMBER 

Explanation: On the ADDRESS parameter, a keyword value for number was not 
within the allowable range of decimal 1 through 256. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP137I UNIT ADDRESS PLUS NUMBER EXCEEDS HEX ADDRESS FF 

Explanation: The keyword value for the unit address (specified on either the 
UNITADD keyword or the ADDRESS keyword) plus the keyword value for 
number (specified on the ADDRESS keyword) exceeds the allowable value of 
hexadecimal FF for a unit address. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword values. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP138I NO lOCP STATEMENTS FOUND 

Explanation: An end-of-file has occurred on the SYSIN data set before lOCP found 
a CHPID, CNTLUNIT, or lODEVICE macro instruction. 

System Action: lOCP does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Ensure that the correct data set was specified for SYSIN. 

Detecting Module: ICPCARDS 
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Issuing Module; ICPCARDS 
Containing Module: ICPCMSG 

ICP139I UNIT OR MODEL PARAMETER CONTAINS 
NON-ALPHANUMERIC CHARACTERS 

Explanation: A non-alphanumeric character was entered from the console screen or 
was found on the UNIT or MODEL parameter. The characters allowed are 
through 9 and A through Z. 

System Action: (1) If the input is from card-image input, lOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an lOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, the I/O device is not added. 

Programmer Response: (1) For input from card-image macro instructions, correct 
the UNIT and/or MODEL parameters. (2) For input from the console screen, enter 
the correct UNIT and/or MODEL values. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP140I INVALID TIMEOUT VALUE. MUST BE Y OR N 

Explanation: A character other than Y or N was found as the keyword value on the 
TIMEOUT parameter. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword value. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP141I **WARNING** THE ABOVE DEVICE(S) DOES NOT HAVE A 
PATH TO OPTCHAN x 

Explanation: lOCP did not find a path from the device(s) to the alternate channel 
specified by the OPTCHAN value on the lODEVICE macro instruction. 

System Action: lOCP prints this warning message following the lODEVICE macro 
instruction in question and continues processing. 

Programmer Response: Ensure that the value specified for the OPTCHAN 

parameter is correct and, by checking the associated CNTLUNIT and CHPID 
macro instructions, ensure that there is a path from the device(s) through a control 
unit to the alternate channel. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 



Chapter 6. lOCP Messages 6-17 



ICP142I **WARNING** DEFAULT OF n USED FOR NUMBER OF UNITS 
SUBPARAMETER 

Explanation: (1) For the 2305 Fixed Head Storage and the 3838 Array Processor, 
lOCP unconditionally assigns a value of 8 to the number of units subparameter. (2) 
When UNIT = 3350P or UNIT = 3351P, lOCP unconditionally assigns a value of 2 
to the number of units subparameter if the user specified 1 . (3) When 
UNIT = 3351P, lOCP unconditionally assigns a value of 4 to the number of units 
subparameter if the user specified 3. 

System Action: lOCP prints this warning message following the lODEVICE macro 
instruction in question and continues processing. 

Programmer Response: Ensure that the UNIT and ADDRESS parameters on the 
lODEVICE macro instruction are correctly coded. If UNIT = 2305 or UNIT = 3838, 
code the value 8 for the number keyword on the ADDRESS parameter. If 
UNIT = 3350P, code a value from 2 to 8. If UNIT = 3351P, code a value of 2 or 4. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 

ICP143I **WARNING** UNABLE TO VALIDATE OPTCHAN FOR 
CHANNEL X DUE TO NON-308X ASSIGNMENT 

Note: This message applies to all the processor complexes listed on the 
cover of this manual, not just the 308X Processor Complex. 

Explanation: lOCP did not find a path from the device(s) to the alternate channel 
specified by the OPTCHAN value on the lODEVICE macro instruction. Channel x 
is defined as a channel used only by processors other than the processor complexes 
listed on the cover of this manual; therefore, channel x is not included in the 
lOCDS. 

System Action: lOCP prints this warning message following the lODEVICE macro 
instruction in question and continues processing. 

Programmer Response: Ensure that a path from the device(s) to the alternate 
channel is not needed for I/O requests on a processor complex listed on the cover of 
this manual. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 

ICP144I xyz IS AN UNACCEPTABLE BASE ADDRESS FOR UNIT 335xP 

Explanation: For UNIT 3350P, the address xyz is an unacceptable base address 
because bits 3 and 4 of the binary value of the byte represenfing y and z must be 
zeroes. The binary value of the base address xyz must be of the form "nnnn nnnO 
Onnn". Thus, y must be an even hexadecimal digit (0, 2, 4, 6, 8, A, C, or E) and z 
must be in the range of through 7. 

For UNIT 335 IP, the address xyz is an unacceptable base address because bits 4 and 
5 of the binary value of the byte representing y and z must be zeroes. The binary 
value of the base address xyz must be of the form "nnnn nnnn OOnn". Thus, y may 
be a hexadecimal digit of through F and z must be in the range of through 3. 
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System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Ensure that the UNIT and ADDRESS parameters on the 
lODEVICE macro instruction are correctly coded. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDX 

Containing Module: ICPCMSG 

ICP145I DEVICE ADDRESS PLUS NUMBER OF UNITS EXCEEDS HEX 
FFF 

Explanation: On the ADDRESS parameter, the keyword value for unit address plus 
the keyword value for number exceeds the allowable value of hexadecimal FFF for a 
device address. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Correct the keyword values. 

Detecting Module: ICPCARDX 

Issuing Module: ICPCARDS 

Containing Module: ICPCMSG 

ICP200I CHPID XX PREVIOUSLY DEFINED 

Explanation: The user has defined a channel path (xx) to be added to the lOCDS, 
but an entry for channel path xx already exists in the lOCDS in storage. 

System Action: (1) If the input is from card-image macro instructions, lOCP deletes 
any channel path entries that were added from multiple definitions on the CHPID 
macro instruction. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, the channel path is 
not added. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate channel paths are not specified on the CHPID macro instructions. (2) 
For input from the console screen, use the display, alter, and delete functions to 
check and correct the channel path entries. 

Detecting Module: ICPCIOCP 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 
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ICP201I SAME CHANNEL NUMBER SPECIFIED FOR CHPID xx AND yy 

Explanation: An existing entry for channel path xx contains the same channel 
number and channel set as the entry for channel path yy that you want to add or 
alter. 

System Action: (1) If the input is from card-image macro instructions, lOCP deletes 
any channel path entries that were added from multiple definitions on the CHPID 
macro instructions. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, the channel path is 
not added or altered. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate channel numbers and channel sets are not specified on the CHPID 
macro instructions. If xx and/or yy is X'FF', check the CHPID macro instructions 
that contain the characters ** instead of a chpid number. (2) For input from the 
console screen, use the display, alter, and delete functions to check and correct the 
channel path entries. 

Detecting Module: ICPCIOCP 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP202I CHPID XX HAS NOT BEEN DEFINED OR IS INVALID 

Explanation: You have requested a swap, display, delete, or alter function for a 
channel path (xx) that does not exist in the lOCDS in storage; or you entered an 
invaUd channel path identifier; or an entry for a control unit to be added specifies a 
channel path (xx) that does not exist in the lOCDS or is invaUd. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the control unit entry. lOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an lOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, lOCP 
does not add the control unit entry or does not perform the requested channel path 
function. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that the channel path is valid and has been previously defined on a CHPID macro 
instruction before it is specified on a CNTLUNIT macro instruction. (2) For input 
from the console screen, use the display, alter, and delete functions to check and 
correct the channel path or control unit entry. 

Detecting Module: ICPCIOCP, ICPSMINT 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP203I CHPID XX DOES NOT SUPPORT BYTE MULTIPLEXING 
OPERATIONS 

Explanation: An entry to be added for channel path xx has specified byte 
multiplexer operation. Byte multiplexer cannot be specified for this channel path. 
Up to four channel paths per side can be specified as byte multiplexer. On the A 
side, the channel paths must be in the ranges of 00 through 03 and 10 through 13 
(hex). On the B side, the channel paths must be in the ranges of 40 through 43 and 
50 through 53 (hex). 
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System Action: (I) If the input is from card-image macro instructions, lOCP does 
not add the channel path, and deletes any channel path entries that were added from 
multiple definitions on the CHPID macro instructions. lOCP continues to check the 
syntax of the remaining macro instructions, but does not generate an lOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, IOC? does not add the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that the CHPID macro instructions are correctly specified. (2) For input from the 
console screen, use the display, alter, and delete functions to check and correct the 
channel path entries. 

Detecting Module: ICPCIOGP 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP204I ALTER NOT VALID. CONTROL UNIT xxx CANNOT BE ON A 
BYTE CHANNEL 

Explanation: You requested, with the alter channel path function, that lOCP 
change the channel path from block to byte multiplexer. One or more shared 
control units (SHARED = Y/YB) or one or more data streaming control units 
(PROTOCL = S) are attached to the channel path. Shared and data streaming 
control units cannot be attached to byte multiplexer channel paths. Control unit xxx 
is the first shared or data streaming control unit that lOCP detected on the channel 
path. 

System Action: lOCP does not alter the channel path entry. 

lOCP Operator Response: Use the display and alter functions to check and correct 
the channel paih or control unit entries. 

Detecting Module: ICPCIOCP 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP205I ALTER NOT VALID. BYTE CHANNEL CAN'T INHIBIT TIMEOUT 
FOR DEVICE xxx 

Explanation: For the alter channel path function, you requested that the channel 
path be changed from block to byte multiplexer. One or more I/O devices specified 
with TIMEOUT = N (fimeout inhibited) are assigned to the channel path. 
TIMEOUT = N is not vahd for I/O devices that are assigned to byte multiplexer 
channel paths. On the channel path, device xxx is the first detected I/O device with 
TIMEOUT = N specified. 

System Action: lOCP does not alter the channel path entry. 

lOCP Operator Response: Use the display and alter functions to check and correct 
the channel path or I/O device entries. 

Detecting Module: ICPCIOCP 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP220I CONTROL UNIT xxx PREVIOUSLY DEFINED 

Explanation: The user has defined a control unit (xxx) to be added to the lOCDS, 

but an entry for control unit xxx already exists in the lOCDS in storage. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the control unit entry. lOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an lOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, lOCP 
does not add the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate control unit numbers are not specified on the CNTLUNIT macro 
instructions. (2) For input from the console screen, use the display, alter, and delete 
functions to check and correct the control unit entries. 

Detecting Module: ICPCIOCU 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP221I MAXIMUM NUMBER OF CONTROL UNITS EXCEEDED 

Explanation: An entry for a control unit to be added exceeds the maximum number 
of control units allowed by lOCP. The maximum is 768. (The maximum of 768 is 
for both the A and B sides combined; the actual number allowed on your system 
might be less.) 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the control unit. lOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an lOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, lOCP 
does not add the control unit entry. 

Programmer Response: Check your I/O configuration listing and reports to ensure 
control units are correctly defined. (1) For input from card-image macro 
instructions, ensure that the CNTLUNIT macro instructions are specified correctly. 
(2) For input from the console screen, use the display, alter, and delete functions to 
check and correct the control unit entries. 

Detecting Module: ICPCIOCU 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP222I DUPLICATE CHPID NUMBERS SPECIFIED 

Explanation: An entry for a control unit to be added contains duplicate channel 
path identifiers. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, lOCP does not add 
the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that channel path identifiers are not duphcated on the CNTLUNIT macro 
instruction. (2) For input from the console screen, enter the correct channel path 
identifiers. 
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Detecting Module: ICPCIOCU 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

1CP223I NEITHER DATA STREAMING NOR SHARED C.U. ALLOWED ON 
BYTE CHANNEL(S) 

Explanation: An entry for a shared control unit or a data streaming control unit 
cannot be added because it specifies one or more byte multiplexer channel paths. 
Shared or data streaming control units cannot be attached to byte multiplexer 
channels. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the control unit entry. lOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an lOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, lOCP 
does not add the control unit entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that shared or data streaming control units are not specified for byte multiplexer 
channel paths. (2) For input from the console screen, use the display, alter, add, and 
delete functions to check and correct the control unit entry. 

Detecting Module: ICPCIOCU 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP224I UNIT ADDRESS SETS EITHER OVERLAP/GENERATE HEX 
ADDRESS FF 

Explanation: An entry for a control unit to be added contains an invalid unit 
address for a device. The unit address (with the number of addresses) either exceeds 
hexadecimal X'FF' or duplicates another unit address. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, lOCP does not add 
the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that the unit addresses specified on the UNIT ADD parameter are correctly specified. 
(2) For input from the console screen, use the display, alter, and add functions to 
check and correct the unit addresses. 

Detecting Module: ICPCIOCU, ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 
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ICP225I CONTROL UNIT NUMBER xxx HAS NOT BEEN DEFINED 

Explanation: Either an entry for control unit xxx that you have attempted to 
display, alter, or delete does not exist in the lOCDS in storage, or an entry for an 
I/O device to be added specifies a control unit number (xxx) that has not been 
previously defined. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the I/O device entry. lOCP continues to check the syntax of the remaining 
macro instructions, but does not generate an lOCDS in storage and does not 
produce configuration reports. (2) If the input is from the console screen, lOCP 
does not add the I/O device entry or does not perform the requested control unit 
function. 

Programmer Response: (1) For input from card -image macro instructions, ensure 
that the control unit has been previously defined on a CNTLUNIT macro 
instruction before the control unit number is used on the lODEVICE macro 
instruction. (2) For input from the console screen, use the add, display, alter, and 
delete functions to check and correct the control unit or I/O device entry. 

Detecting Module: ICPCIOCU, ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP226I ALTER NOT VALID. DEVICE xxx REQUIRES EXISTING 
PROTOCOL/TYPE 

Explanation: For the alter control unit function, you requested that the protocol or 
type (SHARED = Y, YB, or N) values be changed for the control unit. One or more 
I/O devices assigned to the control unit are also assigned to other control units. If a 
device is assigned to more than one control unit, all control units that recognize the 
device must use the same protocol and type (shared) values. Device xxx is the first 
detected device assigned to the control unit. 

System Action: lOCP does not alter the control unit entry. 

lOCP Operator Response: (1) Use the display function to check the control unit or 
I/O device entries. (2) Use the delete function or alter I/O device function to remove 
I/O device(s) from the control unit. (3) Alter the control unit's protocol/type. (4) Use 
the add I/O device function to replace the deleted I/O device(s), or the alter I/O 
device function to add the deleted control unit path(s). 

Detecting Module: ICPCIOCU 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP227I ALTER NOT VALID. DEVICE xxx REQUIRES A REMOVED UNIT 
ADDRESS 

Explanation: For the alter control unit function, you requested the removal of one 
or more unit addresses from the control unit entry. One or more I/O devices 
assigned to the control unit have unit address(es) you are attempting to remove. 
Device xxx is the first detected I/O device assigned to the control unit. 

System Action: lOCP does not alter the control unit entry. 
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lOCP Operator Response: Use the display and alter functions to check and correct 
the control unit or I/O device entries. If you are removing devices from the control 
unit, remove the unit addresses or control unit identifier from the I/O device entries 
first, and then remove the unit addresses from the associated control unit entry. 

Detecting Module; ICPCIOCU 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP228I CHPID XX DOES NOT SUPPORT 4.5 MB DATA STREAMING 

Explanation: A control unit with PROTOCL = S4 has a path to chpid number xx, 
but XX does not support 4.5 megabyte data streaming. On a processor that is not a 
Model X, the only channel path identifiers that do support 4.5 megabyte data 
streaming are: 06, 07, 16, 17, 26, 27, 46, 47, 56, 57, 66, and 67. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of remaining lOCP macro 
instructions. (2) If the input is from the console screen, lOCP neither adds nor alters 
the entry. 

Programmer Response: (1) For input from card-image macro instructions, make 
sure the control unit is attached to the correct channel paths. (2) For input from the 
console, use the Display, Alter, and Add functions to check and correct the control 
unit entry. 

Detecting Module: ICPCIOCU 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP229I MAX # OF CHPID'S PER DSE WITH 4.5 MB CU'S ATTACHED 
HAS BEEN EXCEEDED 

Explanation; lOCP has detected that the maximum number of channel paths per 
DSE that can attach to 4.5 megabyte control units on a Model X processor has been 
exceeded. On a Model X processor, lOCP allows a maximum of two channel paths 
per DSE to attach to control units that have PROTOCL = S4. 

System Action; (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of remaining lOCP macro 
instructions. (2) If the input is from the console screen, lOCP neither adds nor alters 
the entry. 

Programmer Response; (I) For input from card-image macro instructions, make 
sure the control unit is attached to the correct channel paths. (2) For input from the 
console, use the Display, Alter, and Add functions to check and correct the control 
unit entry. 

Detecting Module: ICPCIOCU 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 
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ICP240I I/O DEVICE nnn PREVIOUSLY DEFINED 

Explanation: An entry for an I/O device to be added already exists in the lOCDS in 

storage for I/O device nnn. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the I/O device entry and deletes any I/O device entries that were added from 
multiple definitions on the lODEVICE macro instruction. lOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an lOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, lOCP does not add the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that duplicate I/O device numbers/addresses are not specified on the lODEVICE 
macro instructions. (2) For input from the console screen, use the display, alter, and 
delete functions to check and correct the I/O device entries. 

Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP241I MAXIMUM NUMBER OF I/O DEVICES EXCEEDED 

Explanation: An entry for an I/O device to be added exceeds the maximum number 
of I/O devices allowed. The maximum is 4080. 

System Action: (I) If the input is from card-image macro instructions, lOCP does 
not add the I/O device entry and deletes any I/O device entries that were added from 
multiple definitions on the lODEVICE macro instruction. lOCP continues to check 
the syntax of the remaining macro instructions, but does not generate an lOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, lOCP does not add the entry. 

Programmer Response: Check your I/O configuration to ensure that I/O devices are 
correctly defined. (1) For input from card-image macro instructions, ensure that the 
lODEVICE macro instructions are correctly specified. (2) For input from the 
console screen, use the display, alter, and delete functions to check and correct the 
I/O device entries. 

Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP242I DUPLICATE CONTROL UNIT NUMBERS SPECIFIED 

Explanation: An entry for an I/O device to be added contains duplicate control unit 
numbers. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, lOCP does not add 

the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that control unit numbers are not duphcated on the lODEVICE macro instruction. 
(2) For input from the console screen, enter the correct control unit numbers. 



Detecting Module: ICPCIODV 
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Issuing Module: ICPCARDS, ICPSMAIN 
Containing Module: IGPCMSG 

ICP243I TIMEOUT IS INVALID FOR BYTE CHANNEL (CHPID xx) 

Explanation: TIMEOUT = N is specified for one or more I/O devices that are 
assigned to a byte multiplexer channel path. TIMEOUT =^ N is not valid for I/O 
devices assigned to byte multiplexer channel paths. CHPID xx is the first detected 
byte multiplexer channel path to which the device(s) are assigned. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
reports. (2) If the input is from the console screen, lOCP does not add or alter the 
I/O device entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that TIMEOUT = N is not specified on the lODEVICE macro instruction(s) for I/O 
devices assigned to byte multiplexer channel paths. (2) For input from the console 
screen, use the display, add, and alter functions to check and correct the channel 
path or I/O device entries. 

Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP244I SPECIFIED UNIT ADDRESS DOES NOT EXIST IN CONTROL 
UNIT nnn 

Explanation: A unit address for an I/O device to be added does not exist in the 
range of unit addresses for control unit nnn. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry and deletes any I/O device entries that were added from multiple 
definitions on the lODEVICE macro instruction. lOCP continues to check the 
syntax of the remaining macro instructions, but does not generate an lOCDS in 
storage and does not produce configuration reports. (2) If the input is from the 
console screen, lOCP does not add the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that the correct range of unit addresses is specified on the CNTLUNIT macro 
instruction and the lODEVICE macro instruction. (2) For input from the console 
screen, use the display, alter, and delete functions to check and correct the control 
unit and I/O device entries. 

Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP245I I/O DEVICE nnn HAS NOT BEEN DEFINED 

Explanation: The entry for I/O device nnn that you have attempted to display, alter, 
or delete does not exist in the lOCDS in storage. 

System Action: None. 

Programmer Response: Ensure that the I/O device you have specified is correct and 
that you are using the correct function. 
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Detecting Module: ICPCIODV 
Issuing Module: ICPSMAIN 
Containing Module: ICPCMSG 

ICP246I PROTOCOL/TYPE FOR ATTACHED CONTROL UNITS IS 
INCONSISTENT 

Explanation: An entry for an I/O device to be added has specified two or more 
control units and the control units do not have the same protocol or are not the 
same type (shared, shared block, or nonshared). 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, lOCP does not add 
the entry. 

Programmer Response: (1) For input from card-image macro instructions, ensure 
that the control units are correctly specified on the CNTLUNIT macro instructions 
and that the I/O device is correctly specified on the lODEVICE macro instruction. 
(2) For input from the console screen, use the display, alter, and delete functions to 
check and correct the control unit and I/O device entries. 

Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP247I I/O DEVICE CONNECTED TO MORE THAN ONE CU ON SAME 
CHPID 

Explanation: An entry for an I/O device to be added has specified two or more 
control units and two or more of the control units are attached to the same channel 
path. When a device is assigned to more than one control unit, each control unit 
must be attached to a different channel path. 

System Action: (1) If the input is from card-image macro instructions, lOCP does 
not add the entry. lOCP continues to check the syntax of the remaining macro 
instructions, but does not generate an lOCDS in storage and does not produce 
configuration reports. (2) If the input is from the console screen, lOCP does not add 
the entry. 

Programmer Response: (I) For input from card-image macro instructions, ensure 
that the control units are correctly specified on the CNTLUNIT macro instructions 
and that the I/O device is correctly specified on the lODEVICE macro instruction. 
(2) For input from the console screen, use the display, alter, and delete functions to 
check and correct the control unit and I/O device entries. 

Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 
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ICP248I NO PATH TO CHPID nn FOR THE DEVICE(S) 

Explanation: lOCP did not find a path from the device(s) to the channel path that 
was specified by the PATH value on the lODEVICE macro instruction. 

System Action: lOCP continues to check the syntax of the remaining macro 
instructions but does not generate an lOCDS in storage and does not produce 
configuration reports. 

Programmer Response: Ensure that the value specified on the PATH parameter is 
correct. Check the associated CNTLUNIT and CHPID macro instructions to 
ensure that there is a path from the device(s) through a control unit to the specified 
channel path. 

Detecting Module: ICPCIODV 

Issuing Module: ICPCARDS, ICPSMAIN 

Containing Module: ICPCMSG 

ICP3001 MINIMUM CONFIGURATION WAS NOT DEFINED 

Explanation: To generate an lOCDS, you must define at least one I/O device that 
connects to a control unit connected to a channel path. In addition, the device must 
be either a card reader or magnetic tape. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that a minimum configuration is defined. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP301I MORE THAN 4 BYTE MULTIPLEXOR CHANNELS HAVE BEEN 
DEFINED 

Explanation: lOCP has found more than 4 channel paths defined as byte 
multiplexer (TYPE = BY on CHPID macro instruction). 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that not more than 4 channel paths are specified as 
byte multiplexer. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP302I CHANNEL NUMBER ASSIGNMENT IS NOT CONTIGUOUS 

Explanation: Within a channel set (0 or 1), lOCP found that the assigned channel 
numbers were not consecutive. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that the assigned channel numbers within a channel 
set are consecutive. 

Detecting Module: ICPCGNDS 
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Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 
Containing Module: ICPCMSG 

ICP303I THIS CONFIGURATION EXCEEDS AVAILABLE SYSTEM 
STORAGE 

Explanation: On each side, lOCP cannot allocate storage for more than 4608 
control blocks for devices. (A control block represents a single path to a device; 
thus, a device can have up to four control blocks.) To determine the number of 
control blocks, lOCP performs the following two steps. 

1. For each 370 channel set (0 and 1) on each side, lOCP makes two calculations: 

a. Adds 17 to the number of control blocks. (For devices connected to a 
nonshared control unit (SHARED = N), lOCP generates one control block 
per channel path for each device. For devices connected to a shared control 
unit (SHARED = YjYB), lOCP generates only one control block per channel 
path for all the devices connected to that shared control unit.) 

b. Adds 17 to the product of the number of byte multiplexer channels 
multiplied by 256. 

2. The larger result (a or b) found in Step 1 for channel set is added to the larger 
result found in Step 1 for channel set 1 . 

lOCP issues this error message if the sum found in 
Step 2 exceeds 4608 for either side. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Change your I/O configuration so it requires fewer than 
4608 control blocks per side. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP304I DUPLICATE UNIT ADDRESS xx IN CHPID zz - CONTROL UNIT 
SPECIFICATION 

Explanation: When processing control unit entries, lOCP detected unit address xx 
duplicated on channel path zz. This error can occur if a unit address is assigned to 
two or more control units and the control units are attached to the same channel 
path. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that unit addresses are not duphcated on 
CNTLUNIT macro instructions for a specified channel path. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 
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ICP305I DUPLICATE UNIT ADDRESS xx IN CHPID zz - I/O DEVICE 
SPECIFICATION 

Explanation: When processing I/O device entries, lOCP detected unit address xx 
duplicated on channel path zz. This error can occur if two or more devices with the 
same unit address are assigned to the same control unit. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that unit addresses are not duplicated on 
CNTLUNIT or lODEVICE macro instructions for a specified channel path. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP306I I/O DEVICE xxx IS CONNECTED TO MORE THAN 4 CHPIDS 

Explanation: lOCP has found that I/O device xxx, which is connected to one or 
more control units, is assigned to more than 4 channel paths. A device can only be 
assigned to a combined maximum of 4 channel paths. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that an I/O device is not assigned to more than 4 
channel paths. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP307I MORE THAN 16 CONTROL UNITS ASSIGNED TO CHPID zz 

Explanation: lOCP has found more than 16 control units assigned to channel path 
zz. You can assign a maximum of 16 control units to one channel path. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that not more than 16 control units are assigned to 
one channel path. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP308I MAXIMUM NUMBER OF LOGICAL CONTROL UNITS 
EXCEEDED 

Explanation: lOCP tried to generate more than 256 logical control units. A logical 
control unit is built for (1) each control unit with no devices or no devices shared 
with other control units, and (2) each group of two to four control units that share 
devices between them. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Ensure that the configuration will not exceed 256 logical 
control units. You may need to reduce the number of control units and/or have 
more control units share devices. (The total number of channel paths for a logical 
control unit cannot exceed four.) 
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Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP309I DEVICE COUNT (xxxx) PLUS LOGICAL C.U. COUNT (yyy) 
EXCEEDS 4096 

Explanation: The sum of the number of I/O devices (xxxx) plus the number of 
logical control units (yyy) is greater than 4096, the maximum combined total that 
the processor can handle in 370-XA mode. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: Reduce the number of devices and/or the number of logical 
control units. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPMAIN 

Containing Module: ICPCMSG 

ICP310I LOGICAL CONTROL UNIT SPEC. ERROR FOUND WHILE 
PROCESSING C.U. nnn 

Explanation: (1) lOCP found a specification error while building a logical control 
unit. A logical control unit can have a maximum of four channel paths. The logical 
control unit containing control unit nnn exceeds this maximum. (2) lOCP attempted 
to assign a physical control unit to two logical control units. A logical error has 
occurred in lOCP. 

System Action: lOCP does not complete the generation of an lOCDS in storage. 

Programmer Response: (1) If the logical control unit that contains control unit nnn 
has four or fewer control units, then reduce the number of channel paths. If the 
logical control unit that contains control unit nnn has more than four control units, 
reduce the number to four or fewer by changing the way devices are shared between 
control units. (2)Analyze the logical control unit that contains the physical control 
unit. If the logical control unit is valid, save the console sheet and all associated 
output and notify the system programmer. 

Detecting Module: ICPCGNDS 

Issuing Module: ICPCARDS, ICPCRPT, ICPSMAIN 

Containing Module: ICPCMSG 

ICP400I READ/WRITE OF lOCDS IS INVALID ON THIS PROCESSOR 

Explanation: (1) An option to print a report of an lOCDS or to write an lOCDS 
was specified but running ICPIOCP (MVS) or specifying 308X for the lOCP 
command processor option (VM) only reads or writes an lOCDS for a 308X or a 
908X processor. (2) lOCP issued the MSSFCALL SVC (SVC 122) and received a 
return code of 12. This indicates that the MSSFCALL SVC is not available on the 
processor. 

System Action: lOCP issues message ICP051I and terminates. 
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Programmer Response: (1) If you are verifying an input deck perform one of the 
following and run the job again: 

• For MVS, omit the WRTCDS and REPORT options on the PARM parameters 
of the EXEC statements. 

• For VM, enter the 308X processor option and omit the configuration report and 
lOCDS generation options in the lOCP command. 

If you want to read or write an TOCDS, you must use the lOCP that is for your 
processor complex. (2) Rerun the job on a processor that recognizes the 
MSSFCALL SVC. 

Problem Determination: Related message ICP051I indicates the function lOCP 
attempted. 

Detecting Module: ICPCRTNS, ICPPCNTL 

Issuing Module: ICPPCNTL 

Containing Module: ICPCMSG 

ICP401I lOCDS ACCESS PROBLEM. RETURNED RC =4 x TIMES AND/OR 
RC = 8y TIMES 

Explanation: lOCP has issued the MSSFCALL SVC (SVC 122) nine times and has 
received x number of return codes of 4 and y number of return codes of 8. Return 
code 4 indicates that the processor controller is temporarily busy; return code 8 
indicates that one of the MSSFCALL SVC control blocks (MSFCB or MSFAB) is 
in use. 

System Action: lOCP issues message ICP051I and terminates. 

Programmer Response: Rerun the job. If the problem occurs again, notify your 
system programmer. 

Problem Determination: Related message ICP051I indicates the function lOCP 
attempted. 

Detecting Module: ICPCRTNS, ICPPCNTL 

Issuing Module: ICPPCNTL 

Containing Module: ICPCMSG 

ICP402I MSSFCALL RETURNED AN UNEXPECTED RESPONSE CODE OF 
xxxx HEX 

Explanation: lOCP received an unexpected response from the MSSFCALL SVC 
(SVC 122). Bytes 6 and 7 of the response field in the MSSFCALL data block are 
indicated by xxxx (hex). lOCP was attempting to read or write an lOCDS. 

System Action: lOCP terminates the read or write operation. 

Programmer Response: Rerun the job. If the problem occurs again and the 
response is X'xx40' (indicates a processor controller warm start or hardware failure), 
notify your customer engineer. If the problem occurs again and the response is 
X'xxFO' (where xx is anything other than 41, 42, 43, 44, 45, or 46) or X'xxOO', notify 
the next level of support. 
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Problem Determination: 

1. A response of X'41F0' can occur when more than one user or job tries to access 
an lOCDS concurrently, or if the data set is not open for a read or write, or if 
PROTOCL = S4 was specified in a CNTLUNIT macro instruction and your 
processor has not been upgraded to support a data rate of 4.5 megabytes. 

2. A response of X'42F0' indicates that the lOCDS you want to read or write is 
not vahd on this processor complex. The response can also occur if the abihty 
to write to the lOCDS is not supported on your processor complex. 

3. For a processor complex that is partitioned, a response of X'43F0' occurs if you 
specify a dual write or if you try to read/write an lOCDS in the other partition. 

4. If the processor complex is configured as a multiprocessor and you try to read 
an lOCDS or do a dual write, the following responses may occur: X'44F0' if 
the A side processor controller file (contains the I/O configuration data sets) is 
in diagnostic mode; X'45F0' if the B side processor controller file is in diagnostic 
mode. 

5. A response of X'46F0' indicates that the lOCDS(s) you attempted to write to is 
write-protected. Use the lOCDSM (SYS021) frame to remove the 
write-protection. Then rerun the job. 

If the problem was with a read or a write, system product users can refer to message 
ICP051I for more information on which lOCDS caused the problem. 

If you are running the VM version of lOCP, see the lOCP Command Usage Notes 
in Chapter 3. 

Detecting Module: ICPCWTDS, ICPCRDDS 

Issuing Module: ICPPCNTL, ICPSMAIN 

Containing Module: ICPCMSG 

ICP403I LEVEL nn lOCDS IS INVALID 

Explanation: lOCP received a response from the MSSFCALL SVC (SVC 122) 
where the response field in the MSSFCALL data block has byte 7 set to X'20' and 
byte 6 bit set to 1. This indicates that the lOCDS that lOCP is attempting to read 
is either being updated or was not closed after the last time it was written to. The 
lOCDS is considered invahd. 

System Action: lOCP terminates the read operation. 

Programmer Response: Rerun the job. If the error occurs again, notify your system 
programmer. 

Detecting Module: ICPCRDDS 

Issuing Module: ICPPCNTL, ICPSMAIN 

Containing Module: ICPCMSG 

ICP404I LEVEL nn lOCDS DIRECTORY INVALID 

Explanation: lOCP has read an lOCDS from the processor controller into storage 
and compared the member names and sector sizes in the directory record against the 
expected values. The directory does not match the expected values. This message 
can occur when a 370 level lOCP tries to read a 370/370-XA lOCDS, or when a 
lower level 370/370-XA lOCP tries to read a 370/370-XA lOCDS generated by a 
higher level 370/370-XA lOCP. 
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System Action: lOCP terminates the read operation. 

Programmer Response: Rerun the job. If the problem occurs again, notify your 
system programmer. 

Detecting Module: ICPCRDDS 

Issuing Module: ICPPCNTL, ICPSMAIN 

Containing Module: ICPCMSG 

ICP501A TYPE "PRG": PRESS "ALT", "CMD" KEYS: TYPE "PRGATTN": 
PRESS "ENTER". 

Explanation: lOCP issues this message to instruct the lOCP operator how to enter 
program mode in order to operate lOCP. This message appears after the operator 
has started or restarted lOCP. 

System Action: lOCP waits for an operator response. 

lOGP Operator Response: Perform the following steps: 

• To put the console in program mode, key in the following console command: 
PRG 

• Press and hold down the ALT key and then press the CMD key while holding 
down the ALT key. 

The following message is displayed: 
CONSOLE MODE CHANGED 

• To cause a program attention, key in the following console command: 
PRGATTN 

Press ENTER. 

lOCP displays the primary menu (Figure 4-4) and you can start operating lOCP. 

To take the console out of program mode after you have completed lOCP operation, 
key in FDC (frame dependent command), press and hold down the ALT key, and 
then press the CMD key while holding down the ALT key. 

Detecting Module: ICPSIO 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP502A INPUT NOT CORRECT OR MISSING AT CURSOR POSITION. 
PLEASE CORRECT. 

Explanation: You have entered invalid or incomplete data in the input field where 
the cursor is positioned. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Enter valid data (at the cursor position), or a command. 

Detecting Module: ICPSMINT, ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP503A MORE THAN ONE SELECTION ENTERED. ONLY ONE 
SELECTION ALLOWED. 

Explanation: On an add, alter, delete, or display selection menu, you have entered 
more than one entry. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Make only one entry on the menu and try the function 
again, or enter a command. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP504A NO SELECTION HAS BEEN MADE. PLEASE MAKE SELECTION. 

Explanation: On the add, alter, delete, or display selection menu, you have not 
made a correct entry. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Key in a valid entry on the screen, or enter a command. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP505A CARD INPUT ERROR(S) FOUND. CHECK PRINTER FOR 
LISTING. PROCEED. 

Explanation: lOCP has detected errors in the macro instructions read from the 
input device. The output listing shows the macro instructions read and indicates the 
errors detected. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Correct the errors and try the function again, or enter a 
command. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP506A CARD INPUT ERROR(S) FOUND. NO PRINTER SPECIFIED - NO 
LISTING. PROCEED. 

Explanation: lOCP has detected errors in the macro instructions read from the 
input device. However, you have not specified a printer, so lOCP cannot indicate 
the errors detected. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Try the menu function again and specify a printer to 
receive the output listing. The hsting will indicate the errors detected. Correct the 
errors and try the function again, or enter a command. 

Detecting Module: ICPSMINT 
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Issuing Module: ICPSMAIN 
Containing Module: ICPCMSG 

ICP507A lOCDS GENERATION ERROR(S). CHECK PRINTER FOR 
LISTING. PROCEED. 

Explanation: lOCP has detected errors in the input macro instructions while 
generating an lOCDS in storage. The output Hsting shows the macro instructions 
read by lOCP and indicates the errors detected. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Correct the errors in the input macro instructions and try 
the function again, or enter a command. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP508A lOCDS GENERATION ERROR(S). NO PRINTER SPECIFIED - NO 
LISTING. PROCEED. 

Explanation: lOCP has detected errors in the input macro instructions while 
generating an lOCDS in storage. However, you have not specified a printer, so 
lOCP cannot indicate the errors detected. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Try the menu function again and specify a printer to 
receive the output listing. The listing will indicate the errors detected. Correct the 
errors and try the function again, or enter a command. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP509I ENTRIES BEING PROCESSED. PLEASE WAIT FOR 
COMPLETION. 

Explanation: This message indicates that lOCP is processing the entries for the 
requested function. 

System Action: lOCP locks the keyboard until the function is complete. 

lOCP Operator Response: Wait for and respond to the next message. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMINT 

Containing Module: ICPCMSG 

ICP510I ENTRIES BEING PROCESSED. LISTING WILL BE PRINTED. 

Explanation: lOCP is processing the requested function and the function includes 
producing an output hsting. 

System Action: lOCP locks the keyboard until the function is complete. 

lOCP Operator Response: Wait for and respond to the next message. 

Detecting Module: ICPSMINT 
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Issuing Module: ICPSMINT 
Containing Module: ICPCMSG 

ICP511I ENTRIES BEING PROCESSED. PRINTER NOT SPECIFIED. 

Explanation: lOCP is processing the entries for the requested function and, because 
a printer was not specified, the function does not include an output hsting. 

System Action: lOCP locks the keyboard until the function is complete. 

lOCP Operator Response: Wait for and respond to the next message. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMINT 

Containing Module: ICPCMSG 

ICP512A PROCESSING COMPLETED. PROCEED. 

Explanation: lOCP has processed the data entered on the menu, completed the 
requested function, and detected no errors. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Enter a command, or repeat the menu function. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP513A PROCESSING COMPLETED. CHECK PRINTER FOR LISTING. 
PROCEED. 

Explanation: lOCP has processed the data entered on the menu, completed the 
requested function, and detected no errors. An output listing was produced. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Enter a command, or repeat the menu function. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP514A PROCESSING COMPLETED. NO PRINTER SPECIFIED - NO 
LISTING. PROCEED. 

Explanation: lOCP has processed the data entered on the menu, completed the 
requested function, and detected no errors. An output listing was not produced. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Enter a command, or repeat the menu function. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP515W lOCP TERMINATED. WAIT STATE CODE = B2x. 

Explanation: lOCP has loaded the PSW with a wait state code of B20 through B24. 
See "lOCP Wait State Codes" in Chapter 4 for an explanation of the wait state 
codes. 

System Action; lOCP terminates. 

lOCP Operator Response: See Chapter 4. 

Problem Determination: See Chapter 4. 

Detecting Module: ICPSACP 

Issuing Module: ICPSACP 

Containing Module: ICPSACP 

ICP516A ENTRY ON COMMAND LINE IS NOT CORRECT. RE-ENTER 
WITH CORRECTIONS. 

Explanation: The command you have entered is not a valid command for the menu 
being displayed. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Key in a vaUd command (as shown on hnes 20 and 21), 
or enter the required menu data. 

Detecting Module: ICPSBOTL, ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP517A ONLY ONE " = " DELIMITER IS PERMITTED. PLEASE 
CORRECT. 

Explanation: For a screen command in the form "command = value", you have 
entered more than one " = " in the command. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Correct the input and enter the screen command again. 

Detecting Module: ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP518A VALUE AFTER " = " CONTAINS TOO MANY DIGITS. CHECK 
LENGTH & RE-ENTER. 

Explanation: For a screen command in the form "command = value", you have 
entered too many digits for "value" in the command. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Correct the input and enter the screen command again. 

Detecting Module: ICPSBOTL, ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP519A VALUE AFTER " = " IS NOT VALID. HEX DIGITS ONLY. PLEASE 
CORRECT. 

Explanation: For a screen command in the form "command = value", you have 
entered invalid digits for "value" in the command. Only hexadecimal digits (0 
through 9 and A through F) are vahd on the command. 

System Action: IOC? waits for an operator response. 

lOCP Operator Response: Correct the input and enter the screen command again. 

Detecting Module: ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP521A NO VALUE ALLOWED WITH THIS COMMAND USING THIS 
MENU. PLEASE CORRECT. 

Explanation: You have entered a screen command in the form "command = value" 
on a menu that does not allow this form of command. A "command = value" form 
of screen command can only be entered on an add, alter, or display menu. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Enter a valid command. 

Detecting Module: ICPSBOTL 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP522A VALUE MISSING AFTER " = " DELIMITER. ENTER A VALUE. 

Explanation: For a screen command in the form "command = value", you have not 
entered any digits for "value" after the " = " in the command. 

System Action: lOCP waits for an operator response. 

lOCP Operator Response: Correct the input and enter the screen command again. 

Detecting Module: ICPSSCAN 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 

ICP523I SWAP REQUEST NOT VALID. BOTH CHPIDS MUST BE THE 
SAME CHANNEL TYPE. 

Explanation: You tried to swap two channel paths, but the channel paths are not 
the same type. The channel paths to be swapped must be the same type, either 
block or byte multiplexer. 

System Action: lOCP does not swap the channel paths and does not print 
configuration reports. 

lOCP Operator Response: Enter channel paths that are the same type. 

Detecting Module: ICPSMINT 

Issuing Module: ICPSMAIN 

Containing Module: ICPCMSG 
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ICP550A ddd, INT REQ, CC = 3/NO PATH AVAILABLE 

Explanation: lOCP received a "not operational" condition code, code 3, on the path 
specified. In the message, ddd indicates the device address/number of the device. 

System Action: lOCP waits for the operator to correct the entry or make the path 
available and try the operation again. 

lOCP Operator Response: (1) If the entry for the device was incorrectly specified on 
the screen, correct the entry and try the operation again. (2) If the path is not 
available, turn on the path to the device (such as setting the channel or control unit 
switch) and try the operation again. (3) If the path cannot be made available, run 
lOCP again using another device or path. 

Detecting Module: ICPSINIO, ICPSOTIO 

Issuing Module: ICPSMAIN 

Containing Module: ICPSINIO, ICPSOTIO 

ICP551A ddd,INTREQ,cm,stat,sense 

Explanation: lOCP detected a device that requires operator intervention. In the 
message text in hexadecimal, the fields are: 

ddd Device address/number. 

cm Operation code of the channel command word (COW) during whose 

execution the error occurred. If the channel command word cannot be found, 
this field appears as **. 

Stat Status portion of the channel status word (CSW). 

sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 

System Action: lOCP waits for the operator to end lOCP or try the operation 
again. 

lOCP Operator Response: Check the following and try the operation again. 

• Make the unit ready. If the unit cannot be made ready, run lOCP again using 
another device. 

• Feed more cards to the reader. 

• Clear a card jam. 

• Empty a stacker. 

• Put paper into the printer. 
Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSMAIN 
Containing Module: ICPSINIO, ICPSOTIO 

ICF552A ddd,err,cm,stat,sense 

Explanation: An uncorrectable I/O error was detected by lOCP. Two consecutive 
commas or a blank field in the message text indicates that a field could not be 
determined. 
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In the message text, the fields are: 

ddd Device address/number in hexadecimal. 

err Description of the error based on status and sense information: 

BOC bus out check. 

CGC channel control check. 

CDC channel data check. 

CHC chaining check. 

CMD command reject. 

CPC channel program check. 

DCK data check. 

EQC equipment check. 

ICC interface control check. 

lOE input/output error (for errors other than those described). 

OVR data overrun. 

PRC channel protection check. 

SEN a unit check occurred during a sense operation. (When this condition 
is present, the sense field does not appear in the message text.) 

cm Command code, in hexadecimal, of the channel command word (CCW) being 
executed when the error occurred. If the channel command word cannot be 
found, this field appears as **. 

Stat Status portion, in hexadecimal, of the channel status word (CSW). 

sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 

System Action: lOCP waits for the operator to try the operation again or end 
lOCP. 

lOCP Operator Response: Probable user or hardware error. Try another device on 
another channel. 

Possible values of the err field and appropriate responses are as follows: 

• CMD REJECT - Command reject. Check that device entries on the screen are 
correct. 

• BOC - bus out check. 

• EQC - equipment check. 

• ICC - interface control check. 

• OVR - data overrun 

These are permanent hardware faults. Customer engineer action is required. 
Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSMAIN 
Containing Module: ICPSINIO, ICPSOTIO 
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ICP553A ddd, INT REQ, CC = 3/NO PATH AVAILABLE 

Explanation: Before reading from an input device or writing to an output device, 
lOCP received a "not operational" condition code, code 3, on the path specified. In 
the message, ddd indicates the device address/number. 

System Action: lOCP waits for the operator to make the path available and signal 
lOCP by keying in "PRGATTN" on the command line and pressing ENTER. 

lOCP Operator Response: (1) If the path is not available, turn on the path to the 
device (such as setting the channel or control unit switch) and try the operation 
again. (2) If the path cannot be made available, run lOCP again using another path 
or device. 

Detecting Module: ICPSINIO, ICPSOTIO 

Issuing Module: ICPSINIO, ICPSOTIO 

Containing Module: ICPSINIO, ICPSOTIO 

ICP554A ddd,INTREQ,cm,stat,sense 

Explanation: Before reading from an input device or writing to an output device, 
lOCP detected a device that requires operator intervention. In the message text in 
hexadecimal, the fields are: 

ddd Device address/number. 

cm Operation code of the channel command word (CCW) during whose 

execution the error occurred. If the channel command word cannot be found, 
this field appears as **. 

Stat Status portion of the channel status word (CSW). 

sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 

System Action: lOCP waits for the operator to key in "PRGATTN" on the 
command Hne and press ENTER. 

lOCF Operator Response: Check the following: 

• Make the unit ready. If the device cannot be made ready, run lOCP again using 
another device. 

• Feed more cards to the reader. 

• Clear a card jam. 

• Empty a stacker. 

• Put paper into the printer. 

Key in "PRGATTN" on the command hne and press ENTER. 
Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSINIO, ICPSOTIO 
Containing Module: ICPSINIO, ICPSOTIO 
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ICP555A ddd[,err,cm,$tat,sense 

Explanation: While reading from an input device or writing to an output device, 
lOCP detected an error that can be tried again or ignored. Two consecutive 
commas or a blank field in the message text indicates that the field could not be 
determined. 

In the message text, the fields are: 

ddd Device address/number in hexadecimal. 

err Description of the error based on status and sense information: 

DCK data check. 

EQC equipment check (card reader). 

cm Command code, in hexadecimal, of the channel command word (CCW) being 
executed when the error occurred. If the channel command word cannot be 
found, this field appears as **. 

Stat Status portion, in hexadecimal, of the channel status word (CSW). 

sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 

System Action: lOCP waits for the operator to signal lOCP to try the operation 
again by keying in "PRGATTN" on the command Hne and pressing ENTER. If the 
error occurred on the input device, lOCP tries the read operation again. If the error 
occurred on the output device, lOCP does not reprint the line. 

lOCP Operator Response: Have lOCP try the command again (by keying in 
"PRGATTN" on the command hne and pressing ENTER), or rerun lOCP using 
another device. 

Detecting Module: ICPSINIO, ICPSOTIO 

Issuing Module: ICPSINIO, ICPSOTIO 

Containing Module: ICPSINIO, ICPSOTIO 

ICP556I ddd,err,cni,stat,sense 

Explanation: While lOCP was reading from an input device or writing to an output 
device, an uncorrectable error was detected by lOCP. Two consecutive commas or a 
blank field indicates that a field could not be determined. 

In the message text, the fields are: 

ddd Device address/number in hexadecimal. 

err Description of the error based on status and sense information: 

BOC bus out check. 

CCC channel control check. 

CDC channel data check. 

CHC chaining check. 

CMD command reject. 

CPC channel program check. 

DCK data check. 

j 

EQC equipment check. 
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ICC interface control check. 

lOE input/output error (for errors other than those described). 

OVR data overrun 

PRC channel protection check. 

REC record error. (The record read was not 80 bytes or a multiple of 80 

bytes.) 

SEN a unit check occurred during a sense operation. (When this condition 
is present, the sense field does not appear in the message text.) 

cm Command code, in hexadecimal, of the channel command word (CCW) being 
executed when the error occurred. If the channel command word cannot be 
found, this field appears as **. 

Stat Status portion, in hexadecimal, of the channel status word (CSW). 

sense The sense data can be up to 24 bytes long. The first two sense bytes are for 
the error condition. 

System Action: lOCP terminates by loading a PSW with a wait state code of B23. 
Probable hardware error. (Try another device on another channel.) 

For a magnetic tape device, do not unconditionally accept the results of the 
operation. Check that the tape being used for this job has not been replaced or 
removed. Each message should be considered as a potential warning of a marginal 
condition. 

For a card reader, note that some abnormal error condition occurred. Depending 
on the severity of the error (check status and sense information) and depending on 
the installation requirements, take the appropriate action. 

Possible values of the err field and appropriate responses are as follows: 

• CMD REJECT - Command reject. Correct the command and try the function 
again. 

• BOC - bus out check. 

• EQC - equipment check. 

• ICC - interface control check. 

• OVR - data overrun 

These are permanent hardware faults. Customer engineer action is required. 
Detecting Module: ICPSINIO, ICPSOTIO 
Issuing Module: ICPSINIO, ICPSOTIO 
Containing Module: ICPSINIO, ICPSOTIO 
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lOCP Messages (DMSICP Prefix) 



The following messages are issued only by the VM version of lOCP. The messages 
are arranged in alphanumeric order by message identifier. 

The message format is: 
DMSICPnnnE text 

where: 

nnn is the message number 

text is the message text 

E is an action code that denotes an error. 

Note: The CMS-IOCP interface module, DMSICP, issues these error messages with 
corresponding return codes (RC) for each message. 
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DMSICPOOIE NO FILENAME SPECIFIED 

Explanation: The lOCP command requires that you specify the name of the file 
containing the source lOCP macro instructions or the name of the file to contain the 
lOCP output file. 

System Action: Execution of the command is terminated. The system status 
remains the same. RC = 24 

User Response: Issue the command again and specify the filename of the lOCP 
input or output file. 

DMSICP002E FILE 'filename lOCP' NOT FOUND 

Explanation: The specified file was not found on the accessed disk(s). Either the 
file does not reside on this disk, the file identification was misspelled, or incomplete 
information was provided to cause the appropriate disk to be searched. 

System Action: Execution of the command is terminated. The system status 
remains the same. RC = 28 

User Response: Find or create the desired file. To make sure that the file exists, 
issue either: 

STATE fn ft * or 
LISTFILE fn ft * 

Correct the command and issue it again. 

DMSICP003E INVALID OPTION 'option' 

Explanation: The specified option is invahd. (1) The option may have been 
misspelled. (2) If the option can be truncated, it may have been truncated 
improperly. (3) The option may conflict with another option in the command line. 

System Action: Execution of the command is terminated. The system status remains 
the same. RC = 24 

User Response: Correct the command and issue it again. 

DMSICP006E NO READ/WRITE DISK ACCESSED 

Explanation: The user does not have access to a read/write disk on which the lOCP 
program can write its output file. 

System Action: Execution of the command is terminated. The system status 
remains the same. RC = 36 

User Response: Access a read/write disk and issue the command again, or issue the 
CP LINK command to reset the A-disk to read/write mode. Access the A-disk 
again, and issue the command. 

DMSICP007E FILE 'filename' lOCP IS NOT FIXED, 80 CHAR. RECORDS 

Explanation: The specified file must have fixed length, 80-character records for the 
command to execute. 

System Action: Execution of the command is terminated. The system status 
remains the same. RC = 32 
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User Response: It is possible that an incorrect file name was specified in the 
command hne. In this case, issue the command again. If, however, the file name 
was correct but the file has the wrong format or does not contain 80-character 
records, change the file's format and/or record length with the COPYFILE or 
XEDIT command. 

DMSICP038E FILEID CONFLICT FOR DDNAME 'SYSIN' 

Explanation: Either (1) the user issued a FILEDEF command for reader or tape 
input and the specified filename already exists on disk as fn lOCP, or (2) the user 
issued a FILEDEF command for input from disk with a filetype other than lOCP 
and there exists a file fn lOCP on this disk. 

System Action: Execution of the command is terminated. The system status 
remains the same. RC = 40 

User Response: Check that you have specified the correct filename with the lOCP 
command. If it is correct, for the first explanation, issue a FILEDEF ddname 
CLEAR command for the file, or issue a FILEDEF command that sets the filetype 
correctly. For the second explanation, either use a different filename for the input 
file, or erase the existing disk file. 

DMSICP070E INVALID PARAMETER 'parameter' 

Explanation: An invalid operand was specified in the command line. 

System Action: Execution of the command is terminated. The system status 
remains the same. RC = 24 

User Response: Correct the command line and issue the command again. 

DMSICP075E DEVICE 'devtyp' INVALID FOR INPUT [OUTPUT 

Explanation: The device specified for the input ddname is invalid. This message 
appears if the input device specified is DUMMY, PRINTER, PUNCH or 
TERMINAL. 

System Action: Execution of the command is terminated. The system status 
remains the same. RC = 40 

User Response: Issue the FILEDEF command again and specify the correct input 
device. 

DMSICP099E CMS/DOS ENVIRONMENT ACTIVE 

Explanation: The lOCP command cannot execute while the CMS/DOS environment 
is active. 

System Action: Execution of the command is terminated. The system status remains 
the same. RC = 40 

User Response: Use the SET DOS command to deactivate the CMS/DOS 
environment. Then issue the lOCP command again. 
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Appendix A. Coding lOCP l\/lacro Instructions 



This appendix describes the rules for coding lOCP card-image macro instructions 
and the notation used in this book to describe the macro instructions. 



Rules for Coding lOCP iVIacro Instructions 



The rules for coding lOCP macro instructions are those of the assembler language. 
The following paragraphs are a summary of these rules as stated in 
OSIVS-DOSIVS-VM/370 Assembler Language (GC33-4010; for 370 mode) and 
Assembler H Version 2 Application Programming Language Reference (GC26-4037; 
for both 370 mode and 370-XA mode). 

lOCP macro instructions have the following standard format: 
Name Operation Operand Comments 

Name symbolically identifies the macro instruction. If included, it can contain from 
one to eight alphanumeric characters, the first of which must be alphabetic. The 
name must begin in the first column of the macro instruction and must be followed 
by one or more blanks. The name field of an lOCP macro instruction is ignored by 
lOCP. 

Operation identifies the macro instruction. It must be preceded and followed by one 
or more blanks. The operation field can start in the second column of the macro 
instruction if the name field is not used. 

Operand contains parameters coded in any order and separated by commas. The 
operand field ends with one or more blanks placed after the last parameter. A 
parameter consists of a keyword followed by an equal sign ( = ) and the keyword 
value. The keyword value can be a single value (or subfield) or a Ust of values (or 
subfields). If the keyword value consists of more than one subfield, the subfields 
must be separated by commas and the list of subfields must be enclosed in 
parentheses. When a subfield contains multiple values (such as the UNITADD = 
subfield on the CNTLUNIT macro instruction), these subparameters are positional 
and must be coded in the order shown. The absence of a subparameter is indicated 
by a comma coded in its place. However, if the absent subparameter is the last one 
or if all following subparameters are also absent, do not code any commas to replace 
these subparameters. 

Comments can be written on an lOCP macro instruction, but they must be separated 
from the last parameter of the operand field by one or more blanks. You can use an 
entire card for a comment by placing an asterisk in the first column and the 
characters lOCP in columns 2 through 5 of each card. An * in column 1 or a .* in 
columns 1 and 2 are also valid comment cards but will only be printed if the 
IGNORE = NO parameter is coded. A maximum of two continuation cards can be 
used for comments. 
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lOCP macro instructions are coded in columns 1 through 71 of each card. You can 
continue a macro instruction that exceeds 71 columns onto one or more additional 
cards by placing a nonblank character in column 72 to indicate the continuation. 
The macro instruction can be interrupted either at column 7 1 or after any comma 
that separates parameters. The continued portion must begin in column 16 of the 
following card. Comments can appear on continued cards. Columns 73 through 80 
can be used to code identification and/or sequence characters if you choose. lOCP 
prints but does not examine columns 73 through 80. 

Note; If you incorrectly continue a macro instruction and only optional parameters 
appear on the continued portion, lOCP ignores the optional parameters. For 
example, if you do not end the last parameter on a card with a comma and code a 
nonblank character in column 72, lOCP ignores the information on the continuation 
card. To avoid this possible problem, you can code the optional parameters on the 
first card of the macro instruction. Also, check your I/O configuration reports to 
ensure that all channel paths, control units, and I/O devices are defined correctly. 
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Format and Coding Conventions 



The conventions used in this pubHcation to illustrate the format and coding of lOCP 
macro instructions are: 

• Uppercase letters, numbers, and punctuation marks must be coded exactly as 
shown. 

Exceptions to this convention are brackets, []; braces, {}; and elhpses, ...; which 
are never coded. 

• Lowercase letters represent variables for which you must substitute information 
or specific values. 

• Items enclosed in braces, {}, represent alternative items. Only one of the items 
must be coded. 

• Items enclosed in brackets, [], are optional. They can be omitted. Conversely, 
the lack of brackets indicates that an item must be coded. 

• An ellipsis, ..., indicates that the previous item or group of items can be coded 
two or more times in succession. 

• The "or" sign, i, separates alternative items. 

• If an alternative item is underlined, it is the default value. lOCP assumes the 
default value is your choice if you do not specify the keyword. 

• Single parentheses must enclose single-value subfields, if more than one is coded. 
If only one subfield is specified, you can omit the parentheses. For example, 
you can code either CUNUMBR = (530) or CUNUMBR = 530 on the 
lODEVICE macro instruction. 

• Double parentheses must enclose the UNITADD = subfields on the 
CNTLUNIT macro instruction and the PATH = subfields on the CHPID macro 
instruction because these subfields can contain multiple values. (Single 
parentheses enclose each subfield; another set encloses all the subfields.) For 
example, you code PATH = ((10,E,l),(ll,F)) and PATH = ((12,1)). If only a 
single subparameter for one subfield is specified, you can omit the parentheses. 
For example, you can code either UNITADD = ((0 A)) or UNITADD = 0A. 

• Parameters, subfields, and subparameters coded in the operand field must be 
separated by commas. 
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Examp/e; A typical macro instruction might appear as: 

CUIGA CNTLUNIT CUNUMBR=10A,PATH=06,SHARED=N, X 

UNIT=2821,UNITADD=((0A,3)) Plan 3 

CUIOA is tlie symbolic name of the macro instruction. 

CNTLUNIT identifies the macro instruction to the system. 

CUNUMBR= lOA, PATH -06, and SHARED -N are required parameters, 
separated by commas, containing Iceywords and keyword values. Because the macro 
instruction is continued, a comma follows SHx\RED = N, and a nonblank character 
(X) is placed in column 72. 

UNIT -2821, and UNITADD = ((()A,3)) are also required parameters and start in 
column 16 of the continued macro instruction. Because UNITADD =^((0A,3)) is the 
last parameter, it is followed by a blank to indicate the end of the operand field. 

Plan 3 is a comment. 



A-4 lOGP User's Guide and Reference 



Appendix B. Listings of l\/[acro instruction Input 



Figure B-1 shows a listing of a combined input deck containing both lOCP and 
MVS system generation macro instructions. Figure B-2 shows portions of the Hsting 
produced when lOCP processed the combined input deck shown in Figure B-1. 

Figure B-3 shows a listing of a combined lOCP and MVS Configuration Program 
(MVSCP) input stream. 

Figure B-4 shows a Hsting of lOCP input that contains only lOCP macro 
instructions. Figure B-5 shows a listing of a DMKRIO file used for VM/SP and 
VM/SP HPO system generation. The records in this file correspond to the lOCP 
macro instruction in Figure B-4. Figure B-6 shows a listing of a HCPRIO file used 
for VM/XA Systems Facility system generation. The records in this file correspond 
to the lOCP macro instructions in Figure B-4. 

Note: See "Chapter 5. lOCP Configuration Reports" for examples of the reports 
lOCP produces. 
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XIOCP 
XIOCP 
XIOCP 

!<IOCP 

XIOCP 
XIOCP 
XIOCP 
»«IOCP 

!<IOCP 

XIOCP 
XIOCP 
XIOCP 
XIOCP 

!<IOCP 

XIOCP 
XIOCP 
XIOCP 
SflOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
*fIOCP 
s<IOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 



FLE '0S/VS2 COMBINED MVS AND lOCP 10 CONFIGURATION DECK' 
COPY SGGBLPAK 
ID MSG1='PRACTICE lOCP GENERATION', 

MSG2='SAMPLE CONFIGURATION WITH THREE BYTE CHANNELS- 



DEFINE MVS CHANNELS TO CHPID 



CHANNEL SET 



00 





BYTE 


01 


6 


BYTE 


02 


1 




03 


2 




04 


.^ 




05 


4 




06 


5 




07 


/ 





CHANNEL SET 1 




CHPID I 20 I 21 I 22 I 23 I 24 I 25 I 26 



CHPID PATH=(COO,0,0)),TYPE=BY 
CHPID PATH =(C02, 1,0), ( 24 , 1 , 1 ) ) , TYPE=B 
CHPID PATH=((03,2,0),C25,2,1)),TYPE=B 
CHPIDPATH = ((04,3,0),(26,3,n),TYPE = B 
CHPID PATH=(( 05, 4,0), (27,4,1 )),TYPE:B 
CHPID PATH=((06,5,0),(1G,5,1)),TYPE-B 
CHPID PATH=(C01,6,0),( 1 1 , 6 , 1 ) ) , TYPE=BY 
CHPID PATH=((07,7,0),( 12 , 7 , 1 ) ) , TYPE=B 
CHPID PATH=C( 20,8,0), (13,8,1 )),TYPE=B 
CHPID PATH=((21,9,0), ( 14 , 9 , 1 ) ) , TYP E=B 
CHPIDPATH=(C22,A,0),(15,A,1)),TYPE=B 
CHPID PATH=((23,B,0),(16,B,1)),TYPE=B 
CHPID PATH=((17,C,1)),TYPE=BL 
DEFINE CHANNELS NOT PRESENT ON THIS 3081 

CHPID PATH = ((xs<,D,0) ),TYPE = BL 
CHPID PATH = ((s<x,E,0)),TYPE = BL 
CHPID PATH = <C»<M,F,0)),TYPE = BL 



XIOCP 
XIOCP 
XIOCP 
s«IOCP 
XIOCP 
!<IOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 

X 

UR381Htl CNTLUNIT CUNUMBR=001 , PATH=00 , PROTOCL=D, SHARED=N, 

UNIT=3811,UNITADD=02 
UR38H#2 CNTLUNIT CUNUMBR = 02 , PATH = 00 , PROTOCL =D , SHARED = N , 

UNIT=3811,UNITADD=04 
UR3505#1 CNTLUNIT CUNUMBR=003 , PATH=00 , PROTOCL=D, SHARED=N, 



FORMAT FOR THE CUNUMBR OPERAND IS 
CUNUMBR=XYZ 

X : CHANNEL SET ID 
Y = CHANNEL NUMBER 
Z = SEQUENTIAL NUMBER FROM TO F 

ALL 3830 CONTROL UNITS ARE FEATURED WITH AN ADDRESS 
RANGE OF 16 WHICH IS SPECIFIED ON THE UNITADD OPERAND 
OF THE CNTLUNIT MACRO. 

lOCP SYNTAX CHECKING PERFORMED IN FOREGROUND ON TSO 
ALLOC F(SYSPRINT) DA(X) 

ALLOC FCSYSIN) DA (' CONFIG . lOCPGEN .ASM( lOCP) ' ) SHR 
CALL 'TEST.LOAD(ICPIOCP)' 



CHANNEL ZERO ( BYTE ) 
CHANNEL SET ZERO (0) 



UNIT=3505,UNITADD=((12),(13)) 



00010000 
00020000 

X00030000 
00040000 
00050000 
00060000 
00070000 
00080000 
00090000 
00100000 
00110000 
00120000 
00130000 
00140000 
00150000 
00160000 
00170000 
00180000 
00190000 
00200000 
00210000 
00220000 
00230000 
OC240000 
00250000 
00260000 
00270000 
00280000 
00290000 
00300000 
00310000 
00320000 
00330000 
00340000 
00350000 
00360000 
00370000 
00380000 
00390000 
00400000 
00410000 
00420000 
00430000 
00440000 
00450000 
00460000 
00470000 
O0'i80001 
00490001 
00500003 
00510003 
00520003 
00530000 
00540000 
00550000 
00560000 
00570000 
00580000 
00590000 
00600000 
00610000 
00620000 
00630000 
00640000 
00650000 
00660000 
00670000 
00680000 
00690000 
00700000 
00710000 
00720000 
00730000 
00740000 
00750000 

X00760000 
00770000 

XO078O00O 
00790000 

X00800000 



12 IS 3505,13 IS 3525 00810000 



TP3705EP CNTLUNIT CUNUMBR=004 , PATH^OO , PROTOCL^D, SHARED=N, 

UNIT=37 05,UNITADD=((4D,15),(7F,8),(87,5),CA0,16), 
(B2,62),(FF,1)) 
lODEVICE ADDRESS=0 02,CUNUMBR=0 01,UNIT=3211 
lODEVICE ADDRESS=0 04,CUNUMBR=0 02,UNIT=3211 
lODEVICE ADDRESS=012,CUNUMBR=003,UNIT=3505 

lODEVICE ADDRESS=013,CUNUMBR=0 03,UNIT:3525,FEATURE=TWOLINE 
lODEVICE UNIT=BSC1,ADDRESS=(04D,15),TCU=2701,ADAPTER=BSCA, 

CUNUMBR=004 
lODEVICE UNIT=27 41P,ADDRESS=(07F,8),TCU=27 2,ADAPTER=IBM1, 

SETADDR=1,CUNUMBR=004 
lODEVICE UNlT:2741P,ADDRESS=(087,5),TCU=27 02,ADAPTER=IBni, 

SETADDR=1, FEATURE=AUTOANSR,CUNUMBR=0 04 
lODEVICE UNIT=BSC3,ADDRESS=(0A0,16),TCU=2703, 

FEATURE=AUTOPOLL, ADAPT ER=BSCA,CUNUHBR= 04 
lODEVICE UNIT=BSC3,ADDRESS=(0B2,62),TCU=2703, 

FEATUR E=AUTOPOLL, ADAPT ER:BSCA,CUNUMBR= 04 
lODEVICE UNIT=37 05,ADDRESS=OFF,ADAPTER=CA1,CUNUMBR=0 04 

XIOCP 

XIOCP CHANNEL ONE 

XIOCP . SYMMETRIC DEFINITION OF 2305 DRUMS ACROSS CHANNEL SETS 

XIOCP - 

DR2835(»1 CNTLUNIT CUNUMBR = 01 1 , PATH = C 02 , 24) , PROTOCL = D, SHARED = N, 

UNIT=2835,UNITADD=((D0,8),(D8,8)) 
DR2835#2 CNTLUNIT CUNUMBR=012, PATH=( 02 , 24 ) , PROTOCL=D, SHARED=N, 
UNIT=2835,UNITADD=C(E0,8),(E8,8)) 
lODEVICE ADDR ESS = 1 DO, CUNUMBR = 011, UN IT =23 5, MODEL =2 
lODEVICE ADDRESS = IDS, CUNUMBR = 011, UN IT = 2 3 5, MODEL =2 



XO0820O0O 

XO08300OO 
00840000 
00850000 
00860000 
00870000 
00880000 

X00890000 
00900000 

XO091OOOO 
00920000 

X00930000 
00940000 

X00950000 
00960000 

X00970000 
00980000 
00990000 
01000000 
01010000 
01020007 
01030000 
01040000 

X01050000 
01060000 

X01070000 
01080000 
01090000 
01100000 



Figure B-1 (Part I of 5). A Combined Input Deck (lOCP and MVS System Generation) 
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KIOCP 

KIOCP 
KIOCP 

XIOCP 
XIOCP 
SflOCP 

X 

DA3830ttl 
DA3830tt2 
DA3830tt3 
DA3880»1 



XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 

X 

GP3250 



lODEVICE ADDRES5=1E0,CUNUMBR=012,UNIT=2 3 5,MCDEL:2 
lODEVICE ADDRESS=1E8,CUNUNBR=012,UHIT=2305,MODEL=2 

CHANNEL TWO 
. ALL 3830 CONNECTED SYMilETRIC WITH OPTCHAN DEFINING 

CPU CHANNEL CONNECTIONS (CHANNELS D, E, F ) 
. DEFINE 3380 DEVICES USING THE DATA STREAMING PROTOC 



CNTLUNIT CUNUMBR=02 

UNIT=3830,UNI 
CNTLUNIT CUHUNBR=02 

UNIT=3830,UNI 
CNTLUNIT CUNUMBR=02 

UNIT=3830,UNI 
CNTLUNIT CUNUt-lBR = 02 

UNIT=3880,UNI 
lODEVICE ADDRESS=(2 

OPTCHAN=D,FEA 
lODEVICE ADDRESS=(2 

OPTCIIAN = D,FEA 
lODEVICE ADDRESS=(2 

OPTCHAN=E,FEA 
lODEVICE ADDRESS=(2 

aPTCHAN=F,FEA 



1,PATH=(03,25),PR0T0CL=D,5HARED=N, 

TADD=((10,16)) 

2,PATH=(03,25),PROTOCL=D,SHARED=N, 

TADD=(C<i0,16)) 

3,PATH=(03,25) , PROTOCL^D, SHARED=N, 

TADD=((60,16>) 

't,PATH = (0 5,25),PROTOCL = S,SHARED = N, 

TADD=((80,16)) 

10,8),CUNUMBR=021,UNIT=3330,nODEL=l 

TURE=SHARED 

'tO,<i),CUNUMBR = 22,UNIT = 335 0, 

TURE=SHARED 

6 0,'i),CUNUMBR = 23,UNIT = 3350, 

TURE=SHARED 

8 0,<i) ,CUNUMBR = 02<i,UNIT = 3380, 

TURE=SHARED 



CHANNEL THREE 
CHANNEL SET ZERO (0) 
DEFINE DISPLAY AND GRAPHIC DEVICES 



XIOCP 
XIOCP 
XIOCP 
XIOCP 

DP3272 



XIOCP 
XIOCP 
XIOCP 
XIOCP 

X 

DA3830#') 
DA3830«5 
DA3830n6 



XIOCP 
XIOCP 
XIOCP 



CNTLUNIT CUNUMBR=0 3 0,PATH=C0A),PROTOCL=D,SHARED=YB, 

UNIT = 3258,UNITADD = ((C0,'t)) 
CNTLUNIT CUNUI-1BR = 03I,PATH = (0^),PROTOCL = D,SHARED=YB, 

UNIT=3274,UNITADD=((D0,16)) 
lODEVICE CUNUMBR=0 30,ADDRESS=3C0,UNIT=2250,MODEL=3,PCU 
lODEVICE UNIT=3278,ADDRESS=(3D0,2),CUNUMBR=031, 

FEATURE: (EBKY3277,KB78KEY,SELPEN,DQCHAR, 

AUDALRM),MODEL = 't 
lODEVICE UNIT = 3278.ADDRESS = (3D2,<i),CUNUMBR = 03I, 

FEATURE:(EBKY32 77,KB78KEY,SELPEN,D0CHAR, 

AUDALRM),H0DEL=3 
lODEVICE UNIT=3286,ADDRESS=(3D6,2),MODEL=2,CUNUMBR=03 

FEATURE=DOCHAR 
lODEVICE UNIT=3277,ADDRESS=(3D8,8),CUNUMBR=0 31, 

FEATURE=(EBKY327 7,KB78KEY,SELPEN,D0CHAR, 

AUDALRM),M0DEL=2 

CHANNEL THREE 
CHANNEL SET ONE (1) 



CNTLUNIT CUNUMBR=130,PATH=(26),PROTOCL=D,SHARED=YB, 

UNIT=327 2,UNITADD=((E0,16)) 
CNTLUNIT CUNUMBR=131.PATH=(26),PR0T0CL=D,SHARED=N, 

UNIT=3705,UNITADD=F0 
lODEVICE UNIT = 3277, ADDRESS = (3E0,'(),CUNUMBR = 130, 

FEATURE=(EBKY327 7,KB78KEY,SELPEN,D0CHAR, 

AUDALRM) ,M0DEL=2 
lODEVICE UNIT:37 5,CUNUMBR=131,ADDRESS=3F0,ADAPTER=CA 



CNTLUNIT CUNUMBR = 0'tl,PATH = (05,27,22,15),PROTOCL = D,SHAR 

UNIT=383 0,UNITADD=((10,16)) 
CNTLUNIT CUNUMBR = 0'i2,PATH = (0 5,27,22,15),PROTOCL=D,SHAR 

UNIT=383 0,UNITADD=(<^0,16)) 
CNTLUNIT CUNUMBR = 0<i3,PATH=(0 5,27,22,15),PROTOCL = D,SHAR 

UNIT=3830,UNITADD=((60,16)) 
lODEVICE ADDRESS = ('»10,8),CUNUMBR = 0<il,UNIT = 3330,MODEL = l 

OPTCHAN=A 
lODEVICE ADDRESS = (<t'iO,'i),CUNUMBR: 0^12, UN 11 = 3350, 

OPTCHAN=A 
lODEVICE ADDRESS = (<i6 0,'i),CUNUMBR:0<i3,UNIT = 3350, 

OPTCHAN=A 



CHANNEL FIVE 



XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 

X 

MSCItO 



CNTLUNIT CUNUMBR=051,PATH=(06,10),PROTOCL=D,SHARED=Y, 

UNIT=3803,UNITADD=((80,8)) 
lODEVICE ADDRESS = (58 0,8),CUNUMBR = 51,UNIT:3<(20,MODEL = 

feature: (9-TRACK, OPT 16 0),OFFLINE = YES 







CHANNEL 


SIX 




( BYTE ) 






CHANNEL 


SFT 


ZERO 


(0) 


. MASS 


STORAGE 


CONTROLLER 


:MSCt 


AND 


MSCl) 


. UNIT 


RECORD 


DEVICES 









XIOCP 
XICCP 
XIOCP 
XIOCP 
XIOCP 



CNTLUNIT CUNUMBR=060,PATH=(01,11),UNIT=3851, 

PROTOCL=D,SHARED=N,UNITADD=((10,1)) 
CNTLUNIT CUNUMBR = 061,PATH = (01,11),UNIT = 38-51, 

PROTOCL=D,SHARED = N,UmTADD = ((ll,l)) 
CNTLUNIT CUNUMBR=0 62,PATH:01,UNIT=2821, 

PROTOCL = D,SHARED = N,UNITADD=((0C,<t)) 
lODEVICE UNIT:3851,ADDRESS=( 610,1 ),CUNUMBR=060 
lODEVICE UNI T= 3851, ADDRESS=<611,1),CUNUMBR= 061 
lODEVICE CUNUMBR = 062,UHIT:25<(OR,ADDRESS = 6 0C,MODEL:1, 

FEATURE=CARDIMAGE 
lODEVICE CUNUMBR=0 62, UNIT =251 0P,ADDRESS=6 0D, MODEL =1 
lODEVICE CUNUMBR=062,UNIT:140 3,ADDRESS=(60E,2),MODEL=N 

FEATURE=L)NVCHSET 

CHANNEL SIX ( BYTE ) 
CHANNEL SET ONE (1) 
50KB IP LINE FOR NJP WITH A 2701 



01110000 
01120000 

01130000 

011<i0000 
THER 01150007 
01160007 
01170007 
01180000 
01190000 

X01200001 
01210027 

X01220001 
01230027 

X012'»0001 
01250027 

X01260001 
01270027 

X01280000 
01290001 

X01300003 
01310001 

X01320003 
01350001 

XOU'iOOOO 
01350001 
01360000 
01370000 
01380000 
01390007 
01400000 
01410000 

XO1420O01 
01430027 

X01440001 
01450027 
01460000 

X01470000 

X01480000 
01490000 

X01500022 

X01510000 
01520000 

X01530000 
01540000 

X01550000 

X01560000 
01570000 
01580000 
01590000 
01600000 
01610000 
01620000 

X01630001 
01640027 

X01650000 
01660027 

X01670000 

X01680000 
01690000 
01700000 
01710000 
01720000 
SWITCHES 01730000 
01740000 
01750000 
ED=N, X01760OO0 
01770027 
ED=N, X01780000 
01790027 
ED=N, X01800000 
01810027 

X01820000 
01830000 

X01840000 
01850000 

X01860000 
01870000 
01880000 
01890000 
01900000 
01910000 

X01920000 
01930027 

X01940000 
01950000 
01960000 
01970000 
01980000 
01990011 
02000011 
02010000 
02020000 

X02030011 
02040027 

X02050012 
02060027 

X02070011 
02080000 
02090012 
02100012 
XX02110011 
02120000 
02130011 
XXX02140011 
02150000 

- 02160000 
02170000 
02180000 
02190000 

- 02200000 



Figure B-1 (Part 2 of 5). A Combined Input Deck (lOCP and MVS System Generation) 



Appendix B. Listings of Macro Instruction Input B-3 



x 




02210000 


TP2701 


CNTLUNIT CUNUMBR=16 0,PATH=(11),PROTOCL=D,SHARED=N,UNIT=27 01, 


X02220000 




UNITADD=((0A,2)) 


02230000 




lODEVICE CUNUMBR=160,UNIT=BSC1,ADDRES5=(60A,2),TCU=270I, 


X02240000 




ADAPTER=BSCA 


02250000 


XIOCP 




02260000 




XIOCP 


CHANNEL SEVEN 


02270000 


XIOCP 


EXAMPLE OF STRING SWITCH CONTROL UNIT « 070 AND 090 


02280007 


XIOCP 


WITH OPTIONAL AND ALTERNATE PATHS 


02290019 


XIOCP 


SEE CONTROL UNIT AND DEVICE ON CHANNEL 9 


02300000 


XIOCP 




02310000 
02320000 




DA3830#7 


CNTLUNIT CUNUMBR=07 0,PATH=C07,14),PROTOCL=D,SHARED=N, 


X02330000 




UNIT=3830,UNITADD=C (40,16)) 


02340027 


i<IOCP 
XIOCP 




02350000 
02360000 


CHANNEL EIGHT 


XIOCP 


CHANNEL SET ZERO ( ) 


02370006 


XIOCP 


DEFINE 3800 PRINTER 


02380006 


XIOCP 


. CYRPTO UNIT ( 3848 ) DEFINED TO USE DATA STREAMING PROTOCOL 


02390004 


XIOCP 




02400000 
02410000 




PR3800 


CNTLUNIT CUNUMBR=081,PATH=t20,13),PROTOCL=D,SHARED=N, 


X02420000 




UNITADD=<( 01,1)), UNIT =3800 


02430027 


CU3848 


CNTLUNIT CUNUMBR=082,PATH=(20),PROTOCL=S,SHARED:N, 


X02440006 




UNIT=3848,UNITADD=((C0,1)) 


02450027 




lODEVICE CUNUMBR=081,UNIT:3800,ADDRESS=801,FEATURE=CGS2 


02460000 




lODEVICE CUNUMBR= 082, ADDRESS =( SCO), UNI 1=3848, MODEL =1 


02470006 


XIOCP 




02480006 




XIOCP 


CHANNEL EIGHT 


02490006 


XIOCP 


CHANNEL SET ONE ( 1 ) 


02500006 


XIOCP 
XIOCP 

X 


DEFINE THE ARRAY PROCESSOR (3838) 


02510006 
02520006 
02530006 




AR3838 


CNTLUNIT CUNUMBR=183,PATH=(13),PR0T0CL=D,SHARED=N, 


X02540009 




UNITADD=((E0,8)),UNIT=3838 


02550027 




lODEVICE CUNUMBR=183,UNIT:3838,ADDRESS=8E0 


02560009 


XIOCP 
XIOCP 




02570000 
02580000 


CHANNEL NINE 


XIOCP 


. DEFINE STRING SWITCH DASD ON CONTROL UNIT » 070 , 090 


02590000 


XIOCP 


WITH OPTIONAL AND ALTERNATE PATHS 


02600019 


XIOCP 

X 




02610000 
02620000 




DA38J0»8 


CNTLUNIT CUNUMBR=0 90,PATH=(12,21),PROTaCL=D,SHARED=N, 


X026JOOOO 




UNIT=3830,UNITADD=((40,16)) 


02640027 


DA3830#9 


CNTLUNIT CUNUMBR=0 91,PATH=(14,21),PROTOCL=D,SHARED=N, 


X02650000 




UNIT=3830,UNITADD=((20,16)) 


02660027 


STRINGSW 


lODEVICE ADDRESS=(740,4),CUNUMBR=(070,0 90),UNIT=3350, 


X02670000 




0PTCHAN=9,FEATURE=(ALTCTRL) 


02680000 




lODEVICE ADDRESS=(920,4),CUNUMBR=0 91,UNIT=3350 


02690000 


XIOCP 
XIOCP 




02700000 
02710000 


CHANNEL A 


XIOCP 
XIOCP 


. DEFINE DUMMY UNIT FOR OPTCHAN FROM CHANNEL FOUR (4) 


02720007 
02730000 




X 




02740000 


OPTCHAN 


CNTLUNIT CUNUMBR=0A0,PATH=(22,15),PROTOCL=D,SHARED=N, 


X02750000 




UNIT=DUMMY,UNITADD=((00)) 


02760000 




lODEVICE CUNUMBR=OAO,UNIT=DUMMY,ADDRESS=AOO,DEVTYPE=300 00 01, 


X02770000 


XIOCP 


ERRTAB=223 


02780000 
02790000 




XIOCP 


CHANNEL B 


02800000 


XIOCP 


. TWO. MSS STAGING ADAPTERS (3830-3) WITH A PATH TO EACH 


02810018 


XIOCP 
XIOCP 


STAGING ADAPTER AND THE lODEVICES STRING SWITCHED 


02820018 
02830000 




X 




02840000 


MSSSTGl 


CNTLUNIT CUNUMBR=0B0,PATH=(23) ,PROTOCL=D,SHARED=N, 


X02850026 




UNIT=3830,UNITADD=( (80,64)) 


02860012 


MSSSTG2 


CNTLUNIT CUNUMBR=OB1,PATH=(16),PROTOCL=D,SHARED=N, 


X02870016 




UNIT=3830,UNITADD=((80,64)) 


02880020 


X 




02890018 


XIOCP 


DEFINE THE MSS TABLE PACKS 


02900022 




lODEVICE CUNUMBR=(0B0,0Bl),UNIT=3330,ADDRESS=(B80,2),MODEL=ll 


,X02910022 




FEATURE=(ALTCTRL, SHARED) 


02920024 




lODEVICE CUNUMBR=(0B0,0Bl),UNIT=3330,ADDRESS=(B88,2),MODEL=H 


,X02930022 




FEATURE:(ALTCTRL, SHARED) 


02940025 


X 




02950018 


XIOCP 


DEFINE THE MSS CONVERTIBLE PACKS 


02960022 




lODEVICE CUNUMBR=(OBO,OB1),UNIT=3330,ADDRESS=(B83,2),MODEL=H 


,X02970022 




FEATURE=(ALTCTRL, SHARED) 


02980025 




lODEVICE CUNUMBR=(OBO,OB1),UNIT=3330,ADDRESS=(B8A,2),MODEL=11 


,X02990022 




FEATURE=(ALTCTRL, SHARED) 


03000025 


X 




03010018 


XIOCP 


DEFINE THE MSS STAGING VOLUMES 


03020022 




lODEVICE CUNUMBR=(0B0,0B1),UNIT=3330V,ADDRESS=(B82,1), 


XX03030018 




FEATURE=(ALTCTRL, SHARED) 


03040025 




lODEVICE CUNUMBR=(0B0,0B1),UNIT=3330V,ADDRESS=(B85,3), 


XX03050018 




FEATURE=(ALTCTRL, SHARED) 


03060025 




lODEVICE CUNUMBR=(0B0,0B1),UNIT=3330V,ADDRESS=(B8C,52), 


XX03070018 


XIOCP 


FEATURE=(ALTCTRL, SHARED) 


03080025 
03090000 




XIOCP 


CHANNEL C 


03100000 


XIOCP 
XIOCP 


DEFINE CHANNEL-TO-CHANNEL ADAPTER (CTC) 


03110007 
03120000 




X 




03130000 


CTC 


CNTLUNIT CUNUMBR = 0C0,PATH = 17,PROTGCL'=D,SHARED = N, 


X03140000 




UNIT=CTC,UNITADD=CO 


03150000 




lODEVICE ADDRESS=CC0,CUNUMBR=0C0,UNIT=CTC,FEATURE=370, 


X03160000 


XIOCP 


TIMEOUT=N 


03170000 




03180001 


XIOCP 


CHANNEL D 


03190001 


XIOCP 


THIS CHANNEL IS NOT CONNECTED TO THIS 3081 


03200007 


XIOCP 
XIOCP 


DEVICES ARE OPTCHAN'D FROM CHANNEL 2 


03210007 




03220 01 


X 




03230001 




lODEVICE CUNUMBR=XXX,UNIT=DUMMY,ADDRESS=D0 0,DEVTYPE=30 000001 


X03240001 


XIOCP 


ERRTAB=223 


03250001 




326 01 


XIOCP 


CHANNEL E 


03270001 


XIOCP 


. THIS CHANNEL AND DEVICES ARE NOT CONNECTED TO THIS 3081 


03280007 


XIOCP 
XIOCP 


. DEVICES ARE OPTCHAN'D FROM CHANNEL 2 


03290007 




03300001 



Figure B-l (Part 3 of 5). A Combined Input Deck (lOCP and MVS System Generation) 



B-4 lOCP User's Guide and Reference 



x 03310001 

lODEVICE ADDRESS = (E10,8>,CUNUMBR = '(XX,UNIT = 3330,MODEL = 1 03320001 

lODEVICE ADDRESS = CE'tO,<(),CUNUnBR = >iJ<x,UNIT = 3350, X03330001 

OPTCHAN = F 033'-.0001 

XIQCP 03350001 

!<IOCP CHANNEL F 03360001 

XIOCP . THIS CHANNEL AND DEVICES ARE NOT CONNECTED TO THIS 3081 03370007 

XIOCP . DEVICES ARE DPTCHAH'D FRGH CHANNEL 2 03380007 

xIOCP 033S0001 

x 03^100001 

lODEVICE CUNUMBR = X!<)(,UNIT = DUMMY,ADDRESS = F00,DEVTYPE = 30 000001, XOSiilOOOl 

ERRTAB = 223 03'.20001 

lODEVICE ADDRESS = (F10,8),CUNUMBR = X!<X,UNIT = 3 3 3 0,M0DEL = 1 03ii30001 

lODEVICE ADDRESS = (F60,'i),CUNUNBR = xx)(,UNIT = 3350 03<t<t0001 

EJECT 03't50001 

X XiOtXXXXXXKXXXXXXXXXXXXXXXXXXXXXXKXXXXXXXXXXXiiKXXXXXXXXXXXXXX^tXXXXXX X 03460000 

x X 03470000 

X UNITNAME X 03480000 

X X 03490000 

X XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 03500000 

UNITNAME NAME = SYSRDR,UNn = C012,6aD) 03510000 

UNITNAME NAME=SYSCP,UNIT=(013,60E) 03520000 

SPACE 3 03530000 

UNITNAME NAME=SYSDA,VIO=YES, X03540000 

UNIT=((210,8),(240,4),(260,4),(280,4), XO 3550000 

(410, 8), (440, 4), (460, 4)) 03560000 

UNITNAME NAME=SYSDA,VIO=YES, X03570000 

UNIT=((740,4),(920,4)) 03580006 

UNITNAME NAME=SYSSQ,VIO=YES, X03590000 

UNIT=((210,8),(240,4),(260,4),(280,4), XO 36 00000 

(410, 8), (440, 4), (460, 4)) 3610000 

UNITNAME NAME=SYSSQ,VIO=YES, X03620a00 

UNIT=((740,4),(920,4)) 03630006 

SPACE 3 03640000 

UNITNAME NAME=DASD,VIO=NO, X03650000 

UNIT=((210,8),(24 0,4),(260,4),(280,4), XO 3660000 

(410,8), (440,4), (460,4)) 3670000 

UNITNAME NAME=DASD,VIO=NO, X03680000 

UNIT=((740,4),(920,4)) 03690006 

SPACE 3 03700000 

UNITNAttE NAME = TAPE, X03710000 

UNIT=((580,8)) 03720000 

SPACE 3 03730000 

V3330 UNITNAME NAME=V3330 , VIO=YES,UNIT=( (740 , 4) ) 03740006 

EJECT 03750000 

X XXXXXXXXXXXXXXXKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 03760000 

XXX XX 03770000 

X X X X CONSOLES XXX 03780000 

XXX XX 03790000 

X xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X 03800000 

CONS CONSOLE MCONS=3D0 , ALTCONS=3E0 , ROUTCDE=ALL ,PFK=12 , AREA=14 03810000 

CONSOLE SEC0NS = 3D1,ALTC0NS = 3E1,R0UTCD£ = ALL,PFK = 12, X.03820000 

VALDCnD=(l,2,3),AREA=14 03830000 

CONSOLE SEC0NS=3D2,ALTC0NS=3D3,R0UTCDE=ALL,PFK:24, X03840000 

VALDCMD=(1,2,3),AREA=14 03850000 

CONSOLE SEC0NS=3D3,ALTC0NS=3D4,R0UTCDE=ALL,PFK=24, X03860000 

VALDCMD=(1,2,3),AREA=14 ^S5!I552S 

CONSOLE SEC0NS=3D4,ALTC0NS=3D5,R0UTCDE=ALL,PFK=24, X03880000 

VALDCMD=(1,2,3),AREA=14 °^*'2°SS 

CONSOLE SEC0NS=3D5,ALTC0NS=3D2,R0UTCDE=ALL,PFK=24, X03900000 

VALDCMD=(1,2,3),AREA=14 03910000 

CONSOLE SEC0NS=O-3D6,ALTCONS=O-3D7,R0UTCDE=ALL 03920000 

CONSOLE SEC0NS=O-3D7,ALTCONS=O-3D6,ROUTCDE=ALL 03930000 

CONSOLE SEC0NS=3D8,ALTC0NS=3D9,VALDCMD=(1,2,3), X03940000 

PFK=12,R0UTCDE= (1,2, 3,4,8, 10),AREA= 14 03950000 

CONSOLE SEC0HS=3D9,ALTC0NS=3D8,VALDCMD=(1,2,3), X03960000 

PFK=12,ROUTCDE=(1,2,3,4,8,10),AREA=14 397 00 

CONSOLE SECONS=3EO,ALTCONS=3E1,ROUTCDE=ALL,PFK=12, X03980000 

VALDCMD=(1,2,3),AREA=14 03990000 

CONSOLE SEC0NS=3ei,ALTCONS=3D3,ROUTCDE=ALL,PFK=12, X04000000 

VALDCMD=(1,2,3),AREA=14 040100 

CONSOLE SEC0NS = 3E2,ALTC0NS=^3D4,R0UTCDE = ALL,PFK = 12, X04020000 

VALDCMD=(1,2,3),AREA=14 040 30000 

CONSOLE TYPE=JES,VALDCMD=3 04040000 

EJECT 04050000 

X xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X 04060000 

XXX XXX 04070000 

X X X X CONTROL PROGRAM X x X X 04080000 

XXX XXX 04090000 

X XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 04100000 

CTRL CTRLPROG OPTI0NS=(DEVSTAT, RDE, RER, BLDL , CRH) ,SQA=8, CSA=1000, X04110000 

VRREGN=128,TZ=(U,5),A5CII=INCLUDE,REAL=512,WARN=0, 04120 000 

EJECT 04130000 

X XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 04140000 

XXX XXX 04150000 

X X X X SCHEDULER X x X X 04160000 

XXX XXX 04170000 

X XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 04180000 

SCH SCHEDULR BCLMT=50, XX TSO SCHEDULER REQUEST XX X04190000 

HARDCPY=(SYSLOG, ALL, CMOS), X04200 000 

SUBSYS=(JES4,JES5) 04210000 

EJECT 04220000 

X xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X 04230000 

XXX XXX 04240000 

X X X X CHECK POINT x x X X 04250000 

XXX XXX 04260000 

X XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 04270000 

CHKPT CKPTREST ELIGBLE=( 20 , 100 , 101 , 102, 103 , 1 10 , 120 , 140 , 160 , 4092) 04280000 

EJECT 04290000 

X xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X 04300000 

XXX XXX 04310000 

X X X X DATA MANAGEMENT X X x x 04320000 

XXX XXX 04330000 

X XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 04340000 

DATAMAN DATAMGT ACSMETH= ( BTAM, TCAM, ISAM, GAM, VTAM) , X04350000 

GRAPHCS=(P0RRTNS,GSP),IND=YES,UC5DFLT=ALL 043600 00 

EJECT 04370000 
X xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X 04380000 

x „ X XXX 04390000 

X X X X TSO X X X X 04400000 

XXX XXX 04410000 

X XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX X 04420000 

TSO TSO LOGTIME=600 04430000 

EDIT EDIT DSTYPE:(IPLI),BLOCK=(1680,3120),FORMAT=FIXED, XX04440000 

FIXED=(80-8O),PRMPTR=(IPLI) 04450000 

EJECT 04460000 



Figure B-1 (Part 4 of 5). A Combined Input Deck (lOCP and MVS System Generation) 



Appendix B. Listings of Macro Instruction Input .B-5 



X XXXXXXXXXSiSOfXXifXXXXXXSfXXXXXXXXXXKXXXX 



SVC TABLE 



<XXXXXXXXXXXXXXXXXXXXX X 



K xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
5VCTAB SVCTABLE SVC-255-T1-FC00 , 

SVC-25'(-T4-FC00, 

SVC-25J-T<1-FCOO, 

SVC-252-T3-FC00, 

SVC-251-T3-FC00, 

SVC-250-T'»-FCOO, 

SVC-2'i9-T4-FC00, 

SVC-248-T<t-FC00, 

SVC-2<t7-T'i-FC00, 

SVC-245-T'i-FCOO, 

SVC-2'i5-t'i-FC00, 

SVC-2'i'i-Tl-FCOO, 

SVC-2<i3-Tl-FC00, 

SVC-2'i2-T'i-FC00, 

SVC-2<H-T4-FC00, 

SVC-2'tO-T'i-FCOO, 

SVC-239-T4-FC00, 

SVC-238-T4-FC00, 

SVC-237-T'»-FC00, 

SVC-236-T<i-FC00, 

5VC-235-T4-FC00, 

SVC-23<i-T4-FC00, 

SVC-233-T't-FC(IO, 

SVC-232-T't-FCOO, 

SVC-231-T4-FC00, 

SVC-230-T'i-FCOO, 

SVC-229-T4-FC00, 

SVC-228-T4-FC00, 

SVC-227-T'>-FC00, 

SVC-226-T'i-FCOO, 

SVC-225-T4-FC00, 

SVC-224-T'i-FCOO, 

SVC-223-T3-FC00, 

SVC-222-T3-FCO0, 

SVC-221-T5-FC00, 

SVC-220-T1-FC00, 

SVC-219-T3-FC00, 

SVC-218-T3-FC00, 

SVC-217-T3-FC00, 

SVC-216-T3-FC00, 

SVC-215-T3-FC00, 

SVC-21'i-T3-FC00, 

SVC-213-T3-FC00, 

SVC-212-T2-FC00. 

SVC-211-T2-FC00, 

SVC-210-T2-FC00, 

SVC-209-T3-FCOO, 

SVC-208-T3-FC00, 

SVC-207-T3-FCOO, 

SVC-206-T3-FCO0, 

SVC-205-T5-FCOO, 

SVC-204-T3-FC00, 

SVC-203-T1-FC00, 

SVC-202-T3-FCO0, 

SVC-201-T3-FC00, 

SVC-200-T3-FCOO, 

SVC-199-T1-FCO0, 

SVC-198-T1-FC00, 

SVC-197-T2-FC00, 

SVC-196-T2-FC00, 

SVC-195-T4-FC00, 

SVC-n^-TiJ-FCOO 



IMS TYPE 2 SVC 



IMS-VS 

IMS-VS 1.1. 

IMS-VS 1.1. 

IMS-VS 1.1. 

IMS-VS 1.1. 

IMS-VS 1.1. 
EJECT 
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



. 1 0S-VS2 REL4 SVCS 

0S-VS2 REL* SVCS 

.1 0S-VS2 RELi> SVCS 

0S-VS2 REL4 SVCS 

0S-VS2 REL"* SVCS 

0S-VS2 REL* SVCS 



XXX DATA SETS XXX 

XX XX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

DATASEt IMAGELIB,VOL=(DRV308,3330) 

DATASET JES3LIB,VOL=(DRV308,3330) 

DATASET LIHKLIB,VOL = CDRV308,3331)) 

DATASET MACLIB,VOL=(DRV308,3330) 

DATASET MANX, VOL=(DRV308, 3330) 

DATASEt MANY, VOL=(DRV308, 3330) 

DATASET NUCL EUS, VOL =(DRV308, 333 0) 

DATASET PROCLIB,VOL=CDRV303,3330) 

DATASET SVCLIB,VOL=tDRV308,3330) 

DATASET TELCMLIB,VOL=(DRV308,33 30) 

DATASET UADS,VOL=(DRV308,3330) 

DATASET SAnPLIB,VOL=(DRV308,3330) 

DATASET BRODCAST,VOL=CDRV308,333 0) 

DATASET CMDLIB,VOL=(DRV308,3330) 

DATASET DCMLIB,VOL=(DRV308,3330) 

DATASET HELP, VOL=tDRV308, 3330) 

DATASET PARMLIB,VOL=(DRV308,3330) 

DATASET LPALIB,VOL=(DRV308,3330) 

DATASET VTAML IB, VOL = C DRV 308, 3 330) 

DATASET VSCATLG, VOL =(PAGE08, 3330 ),NAME=PAGE08. CATALOG 

DATASET PAGEDSN=SYS1.PG33301 

DATASET PAGEDSN=SYS1.PG33302 

DATASET PAGEDSN=SYS1.PG33303 

DATASET STGINDEX, VOL =(PAGE08, 3330) 

EJECT 
xxxxxwxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



AFFINITY 



XXX 



KXXXXXXXXXXXXXXXXXXXKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

AFFINITY AFF-AFFPGM01-1,AFF-AFFPGM0 2-0,AFF-AFFPGM0 3-1, 



O')470000 
O'i'tSOOOO 
04<i90000 
O'iSOOOOO 
04510000 
X04520000 
X04530000 
XO'iS'iOO.OO 
X04550000 
X0<t560000 
XO'4570000 
X0't580000 
X04590000 
X04600000 
XOISIOOOO 
X04620000 
X0'(630000 
X0<i640000 
XO-iSSOOOO 
X0't660000 
X04670000 
X0<t680000 
X0't690000 
X04700000 
X0'i710000 
X04720000 
X04730000 
X0'i740000 
X04750000 
X0'i760000 
X0477000a 
X04780000 
X04790000 
X04800000 
X04810000 
X04820000 
XCiBSOOOO 
X04840000 
)i;04850000 
X0<t860000 
X04870000 
X04880000 
X04890000 
X04900000 
X04910000 
X04920000 
X04930000 
X04940000 

xo495nnnn 

X04960000 

X04970000 

X04980000 

X049900Q0 

X05000000 

X05010000 

X05020000 

X05030000 

X05040000 

X05050000 

X05060000 

X05070000 

X05080000 

X05090000 

X05100000 

X05110000 

X05120000 

05130000 

05140000 

05150000 

05160000 

05170000 

05180000 

05190000 

05200000 

05210000 

05220000 

05230000 

05240000 

05250000 

05260000 

05270000 

05280000 

05290000 

05300000 

05310000 

05320000 

05330000 

05340000 

05350000 

05360000 

05370000 

05380000 

05390000 

05400000 

05410000 

05420000 

05430000 

05440000 

05450000 

: 05460000 

: 05470000 

': 05480000 

; 05490000 

X05500000 



AFF-AFFPGM04-d,AFF-AFFPGM05-l, 
AFF-AFFPGM06-0,AFF-AFFPGM07-1 
EJECT 

KXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 



XXX 



GENERATE 



xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx; 
GENERATE GENTYPE=( 10 , 1 ) , 
0BJPDS=SYS1.SSSPDS, 
RESVOL=(DRVJHM,3330), 
INDEX=SSS1, 
JCLASS=N, 
OCLASS=M 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXi 



INCLUDE MACRO FOR 3848 CRYPTO SUPPORT 



xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
ICUCUSP 
END 



X05510000 

05520000 

05530000 

05540000 

XXX 05550000 

X X X X 05560000 

XXX 05570000 

xxxxxxxxxxxxxxxxxxxxxxxxxx X 05580000 

X05590013 

XOS600000 

X05610000 

X05620000 

X05630000 

05640000 

XXXXXXXXXXXXXXXXXXXXXXXXXX X 05650015 

05660015 

05670021 

XXX 05680015 

xxxxxxxxxxxxxxxxxxxxxxxxxx X 05690015 

05700000 

05710000 



Figure B-1 (Part 5 of 5). A Combined Input Deck (lOCP and MVS System Generation) 



5-6 lOCP User's Guide and Reference 



IGNORE=YES 



LISTING OF STATEMENTS PROCESSED BY lOCP AND ERRORS DETECTED 
ID nSGl = 'PR,'CTICE lOCP GENERATION', 

MSG2='SAMIHE CONFIGURATION WITH THREE BYTE CHANNELS 



MIOCP 

»<IOCP 
XIOCP 
XIOCP 
XIOCP 
SilOCP 
XICCP 
XIOCP 
XIOCP 
XICCP 

XIQCP 

KIOCP 
XIOCP 
sflOCP 
XIOCP 
)»IOCP 
XIOCP 
**IOCP 
XIOCP 
islOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 



DEFINE MVS CHANNELS TO CHPID 



CHANNEL SET 



1 00 





1 01 


6 


1 02 


1 


1 03 


?. 


1 0^ 


3 


1 05 


't 


1 06 


5 • 


1 07 


7 



DSE 2 
CHAN I 8 19 I A 
CHPID I 20 I 21 I 22 



CHANNEL SET 1 



I <* 



23 I 2<. I 25 I 26 1 27 I 



1 5 


10 1 


6 


11 1 


7 


12 1 


8 


13 1 


9 


l-i 1 


A 


15 1 


B 


16 1 


C 


17 1 


CHPIDS 



CHPID PATH=(( 
CHPID PATH=( C 
CHPID PATH=(C 
CHPID PATH=t( 
CHPID PATH=CC 
CHPID PATH=(( 
CHPID PATH=(( 
CHPID PATH=CC 
CHPID PATH=(( 
CHPID PATH=(C 
CHPID PATH=(( 
CHPID PATH::C( 
CHPID PATH=CC 
DEFINE CHANNELS 



00,0, 0)),TYPE=BY 
02, 1,0), (2^, 1,1)) 
03,2,0), (25,2 
04, 3,0), (26, 5 
5,<t,0), (27,<t 
06, 5,0), (10, 5 
01, 6,0), (11, 6 
07,7,0) , (12,7 
20,8,0), (13,8 
21,9,0) ,( 11,9 
22, A, 0), (15, A 
23,B,0), (16, B 
17,C,1)),TYPE=BL 
NOT PRESENT ON TH 



,TYPE: 
,TYPE= 
, TYP£= 
,TYPE= 
,TYPE= 
,TYPE= 
, TYPE= 
, TYPE= 
, TYPE= 
,TYPE= 
,TYPE= 



X00030000 
000<50COO 
00050000 
00060000 
00070000 
00080000 
00090000 
OOIOOOOO 
00110000 
00120000 

couoooo 
coitoooo 

00150000 
00160000 
00170000 
00180000 
00190000 
00200000 
00210000 
00220000 
00250000 
002'iOOOO 
00250000 
00260000 
00270000 
002800C0 
00290000 
OO300OCO 
00310000 
00320000 
00350000 
00340000 
00350000 
00360000 
00370000 
003S0OO0 
00390000 
00400000 
00410000 
004200C0 
00430000 
00440000 
00450000 
00460000 
00470000 
00480001 
00490001 
00500005 



TIME 15.20 DATE 82.035 



CHPID PATH=((xx,D,0)),TYPE=BL D — -- 

ICPlllI XXWARNINGXX PATH INFORMATION DEFINED WITH xx IS EXCLUDED FROM lOCDS 

CHPID PATH=((XX,E,0)),TYPE=BL E — — 00510003 

ICPlllI XXWARNINGXX PATH INFORMATION DEFINED WITH xx is EXCLUDED FROM lOCDS 

CHPID PATH=((XX,F,0)),TYPE=BL F -- — 00520005 

ICPlllI XXWARNINGXX PATH INFORMATION DEFINED WITH xx IS EXCLUDED FROM lOCDS 



XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
XIOCP 
UR3811»1 



. FORMAT FOR THE CUNUMBR OPERAND IS 
CUNUMBR=XYZ 

X = CHANNEL SET ID 
Y = CHANNEL NUMBER 
Z = SEQUENTIAL NUMBER FROM TO F 

. ALL 3830 CONTROL UNITS ARE FEATURED WITH AN ADDRESS 
RANGE OF 16 WHICH IS SPECIFIED ON THE UNITADD OPERAND 
OF THE CNTLUNIT MACRO. 

. lOCP SYNTAX CHECKING PERFORMED IN FOREGROUND ON TSO 
ALLOC F(SYSPRINT) DA(X) 

ALLOC F(SYSIN) DA( ' CONFIG . lOCPGEN . ASM( lOCP )' ) SHR 
CALL 'TEST.LOADdCPIOCP)' 

CHANNEL ZERO ( BYTE ) 
CHANNEL SET ZERO (0) 

CNTLUNIT CUNUMBR=0 01,PATH=0 0,PROTOCL=D,SHARED=N, 

UNIT=3811,UNITADD=02 
UR3811»2 CNTLUNIT CUNUMBR=002 , PATH=00 ,PROTOCL=D, SHARED=N, 

UNIT=3811,UNITADD=04 
CNTLUNIT CUNUMBR=0 3,PATH=00,PROTOCL=D,SHARED=N, 

UNIT=3505,UNITADD=((12),(13)) 12 IS 3505,13 IS 352 
CNTLUNIT CUNUMBR=0 04,PATH=0 0,PROTOCL=D,SHARED=N, 

UNIT=3705,UNITADD=((4D,15),(7F,8),(87,5),(A0,16), 

(B2,62),(FF,1)) 
lODEVICE ADDRESS=0 02,CUNUnBR:0 01,UNIT=3211 
lODEVICE ADDRESS=004,CUNUMBR=0 02,UNIT=i211 
lODEVICE ADDRESS=012,CUNUMBR=003,UNIT=3505 

lODEVICE ADDRESS=013,CUNUMBR=0 03,UNIT=3525,FEATURE=TW0LINE 
lODEVICE UNIT:BSC1,ADDRESS=(04D,15),TCU:27 01,ADAPTER=BSCA, 

CUNUMBR=004 
lODEVICE UNIT:2741P,ADDRESS=(07F,8),TCU=27 02,ADAPTER=IBM1, 

SETADDR = 1,CUNUMBR:=004 
lODEVICE UNIT=27 41P,ADDRESS=(087,5),TCU=27 02,ADAPTER=IBM1, 

SETADDR=1,FEATURE=AUTOANSR,CUNUM3R=0 4 
lODEVICE UNIT=BSC3,ADDRES3=(0A0,16),TCU:27 03, 

FEATURE= AUT OPOLL, ADAPT ER=BSCA,CUNUNSR= 04 
lODEVICE UNIT=BSC3,ADDRESS=(CB2,62),TCU=2703, 

FEATURE: AUTO?OLL,ADAPTER=BSCA,CUNUMBR:0 04 
lODEVICE UNIT=37 05,ADDRE5S=OFF,ADAPTeR=CAl,CUNUMBR=0 04 



UR3505«1 
TP3705EP 



XIOCP 
XIOCP 
XIOCP 
XIOCP 



CHANflEL ONE 
SYMELtJIC DEFINITION OF 2305 DRUMS ACROSS CHANNEL SETS 



00530000 
00540000 
00550000 
00560000 
00570000 
00580000 
00590000 
00600000 
00610000 
00620000 
00630000 
00640000 
00650000 
00660000 
00670000 
00680000 
00690000 
00700000 
00710000 
00720000 
00730000 
00740000 

X0076000O 
00770000 

X0O78000O 
00790000 

X0080O00O 
> 00810000 

X0082000O 

X00830000 
00840000 
00850000 
00860000 
00870000 
00380000 

XO089OOOO 
00900000 

XO0910O0O 
00920000 

X00930000 
00940000 

XOC950000 
00960000 

X00970000 
00930000 
005900CO 
01000000 
01010000 
01020007 
01030003 



TIME 15.20 DATE 82.035 



Figure B-2 (Part 1 of 2). A Combined Input Deck Processed by lOCP 



Appendix B. Listings of Macro Instruction Input B-7 



>!IOCP 


lODEVICE ADDRESS = C920,''O,CUNUMBR = 91,UNIT = 3350 


02690000 TIME 15.20 DATE 82.035 PAGE 006 




Uii/UUUUU 




xlOCP 


CHANNEL A 


02710000 




VIOCP 
)<IOCP 
OPTCHAN 


. DEFINE DUMMY UNIT FOR OPTCHAN FROM CHANNEL FOUR d) 


02720007 

02730000 

X02750000 




CNTLUNIT CUNUMBR=:0A0,PATH = C22,15),PRGTOCL = D,5HARED = N, 






UNIT=DUMt1Y,UNITADD=CC0C)) 


02760000 






lODEVICE CUNUNBR=OAO,UNIT=DUMMY,ADDRESS=AOO,DEVTYPE=3D0 001, 


X02770000 




s<IOCP 
XIOCP 


ERRTAB=223 


02730000 
02790000 
02800000 




CHANNEL B 




XIOCP 


. TWO MSS STAGING ADAPTERS C3830-3) WITH A PATH TO EACH 


02810018 




XIOCP 

KIOCP 


STAGING ADAPTER AHD THE lODEVICES STRING SWITCHED 


02820018 
02830000 








t-iSSSTGl 


CNTLUNIT CUNUMBR=OB0,PATH=(23),PROTOCL=D,SHARED=N, 


X02850026 






UNIT = 3830, UNIT ADD = CC SO, 6'r)) 


02860012 




M5SSTG2 


CNTLUNIT CUNUMBR=0B1 ,PATH=C16),PROT0CL=D,SHARED=N, 


X02870016 






UNIT = 3S30,UNITADD = CC80,6<t)) 


02880020 




!(IOCP 


DEFINE THE MSS TABLE PACKS 


02900022 






lODEVICE CUNUMBR = (OB0, OBI), UNIT = 3330,ADDRESS = CBS 0,2 ),MODEL =11 


,X02910022 






FEATURE=CALTCTRL, SHARED) 


0292002<i 






lODEVICE CUNUMBR=COBO,OB1) , UNIT=3330 , ADDR E5S= C B88 , 2 ) , MODcL=l 1 


,X02930022 






FEATURE=CALTCTRL, SHARED) 


029<i0025 




XIOCP 


DEFINE THE MSS CONVERTIBLE PACKS 


02960022 






lODEVICE CUNUMBR=COBO,OB1),UNIT:3330,ADDRESS=(B83,2),MODEL=11 


,X02970022 






FEATURE=CALTCTRL, SHARED) 


02980025 






lODEVICE CUNUriBR = COBO,031),UNIT:3330,ADDRESS = CB8A,2),MODEL = ll 


,X0299C022 






FEATURE=CALTCTRL, SHARED) 


03000025 




XIOCP 


DEFINE THE MSS STAGING VOLUMES 


03020022 






lODEVICE CUNUHBR=:C0B0,0B1),UNIT:3330V,ADDRESS = CB82,1), 


XX030300i8 






FEATURE:CALTCTRL, SHARED) 


O30't0025 






lODEVICE CUNUMBR=C0B0,0B1),UNIT=3330V,ADDRESS=CB85,3), 


XX03050018 








03060025 






lODEVICE CUNUMBR=COBO,OB1),UNIT=3330V,ADDRESS=CB3C,52), 


XXn3070018 




SflOCP 


FEATURE = CALTCTf!L, SHARED) 


03080025 
03090000 








stlOCP 


CHANNEL C 


03100000 




!<IOCP 


DEFINE CHANNEL-TO-CHANNEL ADAPTER CCTC) 


03110007 




>.-IOCP 




03120000 






CTC 


CNTLUNIT CUNUMBR=0C0,PATH=17,PROTOCL=D,SHARED=N, 


X03140000 






UNIT=CTC,UNITADD=CO 


03150000 






lODEVICE ADDRE5S=CC0,CUNUMBR=0C0,UNIT:CTC,FEATURE=37 0, 


X03160000 




JSIOCP 


TIMEOUT=N 


03170000 
031S0001 








XIOCP 


CHANNEL D 


03190001 




XIOCP 


THIS CHANNEL IS NOT CONNECTED TO THIS 3081 


03200007 




!<IOCP 
>!IOCP 


DEVICES ARE OPTCHAN 'D FROM CHANNEL 2 


03210007 
03220001 










lODEVICE CUNUMBR = X)(X,UNIT = DUMMY,ADDRESS = D00,DEVTYPE = 30 000001, 


XO32<iOO01 






ERRTAB=223 


03250001 




ICP117I ^XWARNINGXX THE ABOVE DEVICECS) EXCLUDED FROM THE lOCDS 






XIOCP 
■XIOCP 




03260001 
03270001 




CHANNEL E 




XIOCP 


. THIS CHANNEL AND DEVICES ARE NOT CONNECTED TO THIS 3081 


03280007 TIME 15.20 DATE 82.035 PAGE 007 1 


XIOCP 


. DEVICES ARE OPTCHAN'D FROM CHANNEL 2 


03290007 




5^I0CP 




UOoUUUUi 






lODEVICE ADDRESS=CE10,8),CUNUM3R = »<s<)(,UNIT = 3330,MODEL = l 


03320001 




ICP117I JfxWARNINGxx THE ABOVE DEVICECS) EXCLUDED FROM THE I0CD5 








lODEVICE ADDRESS = CE'»0,'(),CUNUMBR = X'<!<,UNIT = 3350, 


X03330001 






OPTCHAN^F 


033^10001 




ICP117I *(MWARNING!<!< THE ABOVE DEVICECS) EXCLUDED FROM THE lOCDS 


- n'^'^Rnnni 




i*IOCP ' 
XIOCP 


CHANNEL F 


03360001 




»<IOCP 


. THIS CHANNEL AND DEVICES ARE NOT CONNECTED TO THIS 3081 


03370007 




!<IOCP 


. DEVICES ARE OPTCHAN'D FROM CHANNEL 2 


03380007 
03390001 




jflOCP 










lODEVICE CUNUMBR = Xi<>!,UNIT = DUMMY,ADDRESS = F00,DEVTYPE = 30 00 0001 


, X03<tl0001 






ERRTAB=:223 


03'i20001 




ICP117I xxWARNINGxx THE ABOVE DEVICECS) EXCLUDED FROM THE lOCDS 








lODEVICE ADDRESS:CF10,8),CUNUMBR = s<xx,UNIT = 33 3 0,MODEL = l 


03430001 




ICP117I i<xWARNINGX*( THE ABOVE DEVICECS) EXCLUDED FROM THE lOCDS 








lODEVICE ADDRESS = CF60,'i),CUNUMBR = xxx,UNIT=3350 


034'tOOOl 




ICP117I XXWARNING!*** THE ABOVE DEVICECS) EXCLUDED FROM THE lOCDS 






TOTAL MESSAGES FOR SYNTAX CHECKING: 0013 WARNING MESSAGES: 0013 


ERROR MESSAGES: 0000 





Figure B-2 (Part 2 of 2). A Combined Input Deck Processed by lOCI' 



B-S lOCP User's Guide and Reference 



PS2 

* 



lOCONFIG ID=02 



ID02 ID MSG1=' EXAMPLE CONFIGURATION ' 
* 

CHPID PATH=00,TYPE=BY 

CHPID PATH=( (01) , (02) , (03) , (04) , (05) , (06) , (07) , (08) ) ,TYPE=BL 

CHPID PATH=( (09) , (OA) , (OB) , (OC) , (OD) , (OE) , (OF) , (IG) ) ,TYPE=BL 

CHPID PATH=( (11) , (12) , (13) , (14) , (15) , (16) , (17) , (18) ) ,TYPE=BL 

CHPID PATH=( (19) , (lA) , (IB) , (IC) , (ID) , (IE) , (IF) , (20)) ,TYPE=BL 

CHPID PATH=( (21) , (22) , (23) , (24) , (25) , (26) , (27) , (28) ) ,TYPE=BL 

CHPID PATH=( (29) , (2A) , (2B) , (2C) , (2D) , (2E) , (2F) ) ,TYPE=BL 



********************** u|\|ij ADDRESSES 000-OFF ************************* 
* 

* 

CNTLUNIT CUNUMBR=0O,UNIT=3811,UNITADD=((03,4)),SHARED=N, ' 

PATH=(00) 
lODEVICE UNIT=3211,ADDRESS=(0O4,3) ,CUNUMBR=O0 
lODEVICE UNIT=DUMMY,ADDRESS=0O3,CUNUMBR=OO 



aocp 



aocp 



aocp 



aocp 



aocp 



aocp 



CNTLUNIT CUNUMBR=02,UNIT=3203,UNITADD=((07,1)),SHARED=N, 

PATH=(0O) 
lODEVICE UNIT=32O3,M0DEL=4,ADDRESS=(OO7) ,UNITADD=O7,CUNUMBR=02 

CNTLUNIT CUNUMBR=03,UNIT=3800,UNITADD=((0C,1)),SHARED=N, ' 

PATH=(00) 
lODEVICE UNIT=38O0,FEATURE=CGS2, ' 

ADDRESS=(0OC,1),UNITADD=OC,CUNUMBR=O3 

CNTLUNIT CUNUMBR=04,UNIT=3505,UNITADD=((12,4)),SHARED=N, ' 

PATH=(0O) 
lODEVICE UNIT=3505,ADDRESS=(O12,1),CUNUMBR=O4 
lODEVICE UNIT=3525,ADDRESS=(013,1),CUNUMBR=04 
lODEVICE UNIT=1288,ADDRESS=(014,1),CUNUMBR=04 

CNTLUNIT CUNUMBR=05,UNIT=3880,UNITADD=((8O,16)),SHARED=N, ^ 

PATH=(28,2F),PR0T0CL=S 
lODEVICE UNIT=3351P,ADDRESS=(O80,2) ,CUNUMBR=05,UNITADD=80 

CNTLUNIT CUNUMBR=O6,UNIT=388O,UNITADD=((C0,32)),SHARED=N, ' 

PATH=(20,2A),PR0T0CL=S 
lODEVICE UNIT=3350P,ADDRESS=(0C0,8) ,CUNUMBR=06,UNITADD=CO 

CNTLUNIT CUNUMBR=07,UNIT=3705,UNITADD=((EO,16),(F1,3)), ' 

PATH=00,SHARED=N 
lODEVICE UNIT=2741C,ADDRESS=(0EO,16),CUNUMBR=07JCU=27O3, ' 

ADAPTER=IBM1 , FEATURE=AUTOANSR 
lODEVICE UNIT=3705,ADDRESS=(OF1,3) ,CUNUMBR=07,ADAPTER=CA1 



Figure B-3 (Part 1 of 9). A Combined lOCP and MVS Configuration Program Input Stream 



Appendix B. Listings of Macro Instruction Input B-9 



********************** UNIT ADDRESSES 100-lFF ************************* 



CNTLUNIT CUNUMBR=1G,UNIT=3880,UNITADD={(OO,32)),SHARED=N, 

PATH=(01,GB),PR0T0CL=S 
lODEVICE UNIT=3351P,ADDRESS=(100,2) ,CUNUMBR=10,UNITADD=00 
lODEVICE UNIT=3351P,ADDRESS=(110,2) ,CUNUMBR=10,UNITADD=10 



aocp 



aocp 



CNTLUNIT CUNUMBR-11,UNIT=3880,UNITADD=((2O,32)),SHARED=N, 

PATH=(06,1F),PROT0CL=S 
CNTLUNIT CUNUMBR=16,UNIT=388O,UNITADD=((20,32)),SHARED=N, 

PATH=(07,29),PROT0CL=S 
lODEVICE UNIT=3351P,ADDRESS=(120,4) ,CUNUMBR=(11,15) 
lODEVICE UNIT=3351P,ADDRESS=(130,4) ,CUNUMBR=(n,16) 



CNTLUNIT CUNUMBR=13,UNIT=3880,UNITADD=((60,32)),SHARED=N, 

PATH=(10,1A),PR0T0CL=S 
lODEVICE UNIT=335OP,ADDRESS=(160,4) ,UNITADD=60,CUNUMBR=13 



********************** UNIT ADDRESSES 200-2FF ************************* 



CNTLUNIT CUNUMBR=2O,UNIT=3880,UNITADD=((20,16)), 
PATH=(13,2F) ,PROTOCL=S,SHARED=N 

CNTLUNIT CUNUMBR=21,UNIT=3880,UNITADD=((20,16)), 
PATH=(1G,25) ,PROTOCL=S,SHARED=N 

lODEVICE UNIT=3380,ADDRESS=(220,16) ,UNITADD=20, 
CUNUMBR=(2G,21),STADET=N,FEATURE=ALTCTRL 



aocp 



CNTLUNIT CUNUMBR=22,UNIT=388O,UNITADD=((70,16)), 

PATH=(1B) ,PROTOCL=S,SHARED=N 
CNTLUNIT CUNUMBR=23,UNIT=3880,UNITADD=((70,16)) , 

PATH=(25,17) ,PROTOCL=S,SHARED=N 
lODEVICE UNIT=3380,FEATURE=(ALTCTRL, SHARED) , 

ADDRESS=(270,16),UNITADD=70,CUNUMBR=(22,23) 



Figure B-3 (Part 2 of 9). A Combined lOCP and MVS Configuration Program Input Stream 



B-10 lOGP User's Guide and Reference 



*********************** UNIT ADDRESSES 3O0-3FF ************************** 



CNTLUNIT CUNUMBR=30,UNIT=3274,UNITADD=( (60,32)), 

PATH=(05),SHARED=N 
lODEVICE UNIT=3270,M0DEL=X, * 

FEATURE=(EBKY3277,KB78KEY,SELPEN,D0CHAR,AUDALRM,PTREAD),* 

ADDRESS=(36O,16),UNITADD=60,CUNUMBR=3G 



*IOCP 



CNTLUNIT CUNUMBR=31,UNIT=3274,UNITADD=((CQ,32)), 
PATH=(OF),SHARED=N 

lODEVICE UNIT=327G,M0DEL=X, 

FEATURE=(EBKY3277,KB78KEY,SELPEN,D0CHAR,AUDALRM), 
ADDRESS=(3C0,16),UNITADD=Ce,CUNUMBR=31 

lODEVICE UNIT=3270,M0DEL=X, 

FEATURE=(EBKY3277,KB78KEY,SELPEN,D0CHAR,AUDALRM), 
ADDRESS=(3D0,6),UNITADD=D0,CUNUMBR=31 

lODEVICE UNIT=3286,M0DEL=2, 
FEATURE=DOCHAR, 
ADDRESS=(3D6,2),UNITADD=D6,CUNUMBR=31 

lODEVICE UNIT=3270,M0DEL=X, 

FEATURE=( EBKY3277 , KB78KEY , SELPEN , DOCHAR, AUDALRM) , 
ADDRESS=(3D8,8),UNITADD=D8,CUNUMBR=31 



Figure B-3 (Part 3 of 9). A Combined lOCP and MVS Configuration Program Input Stream 



Appendix B. Listings of Macro Instruction Input B-11 



********************** [j|\|iT ADDRESSES 40G-4FF ************************* 



CNTLUNIT CUNUMBR=48,UNIT=3830,UNITADD=((1G,16)), ' 

PATH=(0A,14),SHARED=N 
lODEVICE UNIT=333G,ADDRESS=(410,16),FEATURE=SHARED,CUNUMBR=48 



lOCP 



lOCP 



aocp 



*IOCP 



CNTLUNIT CUNUMBR=49,UNIT=388O,UNITADD=((20,16)), * 

PATH=(02) ,SHARED=N,PROTOCL=S 
CNTLUNIT CUNUMBR=4A,UNIT=3880,UNITADD=((20,16)), * 

PATH=(0C,16),SHARED=N,PR0T0CL=S 
lODEVICE UNIT=3380,FEATURE=(ALTCTRL,SHARED) ,ADDRESS=(420,16) ,* 

CUNUMBR=(49,4A) 



CNTLUNIT CUNUMBR=41,UNIT=3880,UNITADD=((70,16)) 
PATH=(0A,14) ,SHARED=N,PROTOCL=S 

lODEVICE UNIT-338G, FEATURE=(ALTCTRL, SHARED) , 
ADDRESS=(470,16),UNITADD=7O,CUNUMBR=41 



CNTLUNIT CUNUMBR=42,UNIT=383O,UNITADD=((A0,16)), 

PATH-(02,24),SHARED=N 
CNTLUNIT CUNUMBR=43,UI\IIT=3830,UNITADD=((A0,16)), 

PATH=(GC,16),SHARED=N 
lODEVICE UNIT=3330,MODEL=11, 

FEATURE={SHARED,ALTCTRL), 

ADDRESS=(4A0,16),UNITADD=A0,CUNUMBR=(42,43) 



CNTLUNIT CUNUMBR=44,UNIT=3880,UNITADD=((E0,16)), 

PATH=(12) ,SHARED=N,PROTOCL=S 
CNTLUNIT CUNUMBR=45,UNIT=388O,UNITADD=((E0,16)), 

PATH=(0C,28) ,SHARED=N,PROTOCL=S 
lODEVICE UNIT=3380,FEATURE=(ALTCTRL, SHARED) , 

ADDRESS=(4EO,8),UNITADD=E0,CUNUMBR=(44,45) 



Figure B-3 (Part 4 of 9). A Combined lOCP and MVS Configuration Program Input Stream 
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********************** UNIT ADDRESSES 500-5FF *********************** 



CNTLUNIT CUNUMBR=5G,UNIT=348G,UNITADD=((60,16)), 

PATH=(GE,04) ,SHARED=N,PROTOCL=S 
lODEVICE UNIT=3480,FEATURE=(SHARABLE),OFFLINE=YES, 

ADDRESS=(550,O2),UNITADD=6G,CUNUMBR=50 
IGDEVICE UNIT=348G,GFFLINE=NG, 

ADDRESS=(562,G4),UNITADD=62,CUNUMBR=5G 
lODEVICE UNIT=348G,FEATURE=(SHARABLE) ,GFFLINE=YES, 

ADDRESS=(566,1G),UNITADD=66,CUNUMBR=5G 



^IGCP 



CNTLUNIT CUNUMBR=52,UNIT=38G3,UNITADD=((8G,16)), 
PATH=(G4,GE),SHARED=Y 

lODEVICE UNIT=342G,M0DEL=8,0FFLINE=YES, 
FEATURE=(9-TRACK,ALTCTRL,0PT16GG), 
ADDRESS=(58G,5),UNITADD=8G,CUNUMBR=52 

lODEVICE UNIT=342G,M0DEL=5,0FFLINE=YES, 
FEATURE=(9-TRACK,ALTCTRL) , 
ADDRESS=(585,1) ,UNITADD=85,CUNUMBR=52 

IGDEVICE UNIT=342G,MGDEL=8,GFFLINE=YES, 
FEATURE=(9-TRACK,ALTCTRL,0PT16GG), 
ADDRESS-(586,lG),UNITADD=86,CUNUMBR-52 



********************** ywTj ADDRESSES 6G0-6FF ************************* 



CNTLUNIT CUNUMBR=6O,UNIT=383Q,UNITADD=((0G,16)), 

PATH=(06),SHARED=N 
CNTLUNIT CUNUMBR=61,UNIT=383G,UNITADD=((GG,16)), 

PATH=(13),SHARED=N 
IGDEVICE UNIT=3330,ADDRESS=(6GO,16),UNITADD=GG, 

FEATURE=(SHARED,ALTCTRL),CUNUMBR=(6G,61) 

aocp 

CNTLUNIT CUNUMBR=62,UNIT=388G,UNITADD=((6G,16)), 
PATH=(GA,1E),SHARED-N,PRGTGCL=S 

CNTLUNIT CUNUMBR=63,UNIT=388G,UNITADD=((6G,16)), 
PATH=(14) ,SHARED=N,PRGTOCL=S 

IGDEVICE UNIT=338G,ADDRESS=(66G,16) ,UNITADD=6Q, 
FEATURE=(SHARED,ALTCTRL),CUNUMBR=(62,63) 



aocp 



CNTLUNIT CUNUMBR=64,UNIT-3880,UNITADD=((8G,16)) 
PATH=(0A,1E),SHARED=N,PRGTGCL=S 

CNTLUNIT CUNUMBR=65,UNIT=3880,UNITADD=((8G,16)) 
PATH=(14) ,SHARED=N,PRGTOCL=S 

lODEVICE UNIT=338G,ADDRESS=(58G,16) ,UNITADD=80, 
FEATURE=(SHARED,ALTCTRL) ,CUNUMBR=(54,65) 



Figure B-3 (Part 5 of 9). A Combined lOCP and MVS Configuration Program Input Stream 
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^ _ 

********************** UNIT ADDRESSES 70G-7FF ************************* 
* 

CNTLUNIT CUNUMBR=74,UNIT=388O,UNITADD=((C0,16)), ' 

PATH=(OD) ,PROTOCL=S,SHARED=N 
CNTLUNIT CUNUMBR=75,UNIT=3880,UNITADD=((CO,16)), ' 

PATH=(17) ,PROTOCL=S,SHARED=N 
lODEVICE UNIT=338O,ADDRESS=(7C0,16),UNITADD=CG, ' 

FEATURE=(SHARED,ALTCTRL),CUNUMBR=(74,75) 



*IOCP 



CNTLUNIT CUNUMBR=73,UNIT=2835,UNITADD=((F0,16)), 

PATH=(03,0D),SHARED=N 
lODEVICE UNIT=2305,MODEL=2, 

ADDRESS=(7F0,1),UNITADD=F0,CUNUMBR=73 
lODEVICE UNIT-2305,MODEL=2, 

ADDRESS=(7F8,1),UNITADD=F8,CUNUMBR=73 



■k-kir-k-k-k-k-k-k-k-k-klc-k-k-k-k-k-k-k-k* y|\|JJ ADDRESSES 800-8FF ************************* 



CNTLUNIT CUNUMBR=82,UNIT=3880,UNITADD=((70,16)), 

PATH-(21) ,SHARED=N,PROTOCL=S 
CNTLUNIT CUNUMBR=83,UNIT=3880,UNITADD=((70,16)), 

PATH=(2B,09) ,SHARED=N,PR0TOCL=S 
lODEVICE UNIT=3380,FEATURE=(SHARED,ALTCTRL) , 

AODRESS=(870,8),UNITADD=70,CUNUMBR=(82,83) 



aocp 



CNTLUNIT CUNUMBR=85,UNIT=3880,UNITADD=((C0,16)), 

PATH=(21,26) ,SHARED=N,PROTOCL=S 
CNTLUNIT CUNUMBR=86,UNIT=388O,UNITADD=((C0,16)), 

PATH=(2B) ,SHARED=N,PROTOCL=S 
lODEVICE UNIT=338G,CUNUMBR=(85,86) , 

FEATURE=(SHARED,ALTCTRL), 

ADDRESS=(8C0,8) ,UNITADD=C0, 



Figure B-3 (Part 6 of 9). A Combined lOCP and MVS Configuration Program Input Stream 
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********************** ufjjj ADDRESSES 9G0-9FF ************************* 



* 

CNTLUNIT CUNUMBR=90,UNIT=3880,UNITADD=( (70,16)), 

PATH=(1D) ,SHARED=N,PROTOCL=S 
lODEVICE UNIT=338O,FEATURE=SHARED,ADDRESS=(970,8) ,CUNUMBR=90 
*IOCP 



CNTLUNIT CUNUMBR=93,UNIT=388G,UNITADD=((D0,16)), ' 

PATH=(1D,27) ,SHAREO=N,PROTOCL=S 
lODEVICE UNIT=335e,FEATURE=SHARED,ADDRESS=(9D0,16),CUNUMBR=93 



********************** (ji^ij ADDRESSES A00-AFF ************************* 



CNTLUNIT CUNUMBR=A2,UNIT=3880,UNITADD=((7G,16)), 

PATH=(1E,28) ,SHARED=N,PROTOCL=S 
lODEVICE UNIT=3380,FEATURE=SHARED,ADDRESS=(A70,8),CUNUMBR=A2 



********************** ui^ij ADDRESSES BOO-BFF ************************* 



CNTLUNIT CUNUMBR=B2,UNIT=380O,UNITADD=((G1,4)), 

PATH=(04),SHARED=N 
lODEVICE UNIT=380O,MODEL=3,FEATURE=BURSTER,CUNUMBR=B2, 
ADDRESS=(B01,3) ,UNITADD=01, 
*IOCP 

CNTLUNIT CUNUMBR=B3,UNIT=3811,UNITADD=((07,1)), 

PATH=(08,O9),SHARED=N 
lODEVICE UNIT=3211,CUNUMBR=B3,ADDRESS=B07,UNITADD=07 



********************** (ji^ij ADDRESSES C0O-CFF ************************* 



CNTLUNIT CUNUMBR=C1,UNIT=CTC,UNITADD=((C0,32)),PATH=(15), * 

SHARED=N 
lODEVICE UNIT=CTC,FEATURE=370, * 

ADDRESS=(CCO,32),UNITADD=C0,CUNUMBR=C1,TIMEOUT=N 



Figure B-3 (Part 7 of 9). A Combined lOCP and MVS Configuration Program Input Stream 



Appendix B. Listings of Macro Instruction Input B-15 



********************** iiMTT ADDRESSES DOO-DFF ************************* 



CNTLUNIT CUNUMBR=DO,UNIT=3880,UNITADD=((2O,16)) , 

PATH= ( 18) , SHARED=N , PROTOCL=S 
CNTLUNIT CUNUMBR=D1,UNIT=388O,UNITADD=((20,16)), 

PATH=(22,2C) ,SHARED=N,PROTOCL=S 
lODEVICE UNIT=3380,CUNUMBR=(DO,D1) ,ADDRESS=(D20,8) , 

FEATURE= (SHARED, ALTCTRL),UNITADD=20 



^lOCP 



CNTLUNIT CUNUMBR=D2,UNIT=3880,UNITADD=((7O,16)), 

PATH=(18) ,SHARED=N,PROTOCL=S 
CNTLUNIT CUNUMBR=D3,UNIT=3880,UNITADD=((70,16)), 

PATH= (22 , 08) , SHARED=N , PROTOCL=S 
lODEVICE UNIT=3380,FEATURE=(SHARED,ALTCTRL) , 

ADDRESS=(D7O,8),UNITADD=70,CUNUMBR=(D2,D3) 



********************** uf^jj ADDRESSES E00-EFF ************************* 



CNTLUNIT CUNUMBR=EO,UNIT=3880,UNITADD=((20,16)), 

PATH=(19) ,SHARED=N,PROTOCL=S 
CNTLUNIT CUNUMBR=E1,UNIT=3880,UNITADD=((20,16)), 

PATH=(23,2E),SHARED=N,PROT0CL=S 
lODEVICE UNIT=3380,ADDRESS=(E20,16) ,UNITADD=20, 

FEATURE=(SHARED,ALTCTRL),CUNUMBR=(E0,E1) 



aocp 



CNTLUNIT CUNUMBR=E2,UNIT=3880,UNITADD=((7O,16)), 

PATH=(19) ,SHARED=N,PROTOCL=S 
CNTLUNIT CUNUMBR=E3,UNIT=3880,UNITADD=((7O,16)), 

PATH= (23 , 2D) , SHARED=N , PROTOCL=S 
lODEVICE UNIT=3380,ADDRESS=(E7O,8) ,UNITADD=70, 

FEATURE=(SHARED,ALTCTRL),CUNUMBR=(E2,E3) 



Figure B-3 (Part 8 of 9). A Combined lOCP and MVS Configuration Program Input Stream 
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*********************************************************************** 

******* UNITNAMES ******* 

*********************************************************************** 



SPACE 3 
SYSRDR UNITNAME NAME=SYSRDR,UNIT=(012) 
SYSPR UNITNAME NAME=SYSPR,UNIT=(GO4,GG6,OG7,0OC,BG1,BG7) 
TAPE UNITNAME NAME=TAPE,UNIT=((58G,16)) 
DASD23Q5 UNITNAME NAME=DRUM,VIO=NO, 

UNIT=(7F0,7F8) 
DASD335G UNITNAME NAME=DISKAA,VIO=NO, 

UNIT=((GC0,8),(16Q,4)) 
DASD3351 UNITNAME NAME=DISKBB,VIO=NO, 

UNIT=((G8Q,2),(100,2),(11G,2)) 
DASD3380 UNITNAME NAME=DASD,VIO=NO, 

UNIT=((22G,16),{27G,16), 

(66G,16),(68G,8),(688,8), 

(7CG,16),(9DG,16),(A7G,Q8), 

(D20,8),(D7G,8),(E20,16)) 
SYSD338G UNITNAME NAME=SYSDA,VIO=YES, 

UNIT=((22G,16),(27G,16), 

(42G,16),(47G,16),(4AG,8), 

(660, 16), (68G, 8), (688, 8), 

(7CG,16),(9DG,16),(A7G,08)) 
SYSQ338G UNITNAME NAME=SYSSQ,VI0=YES,UNIT=((22G,16) ,(27G,16) 

(7CG,16),(9DG,16),(A7G,Q8), 

(D2G,8) , (D7G,8) , (E2G, 16) , (E7G,8) ) 



*********************************************************************** 
******* Mjp CONSOLES ******* 

*********************************************************************** 



CONSOLES NIPCON DEVNUM=(3D1,361,3C4,3D4,3D8) 

NIPCON DEVNUM=(36G,363,3D0,3C7,3C8,3CE) 



Figure B-3 (Part 9 of 9). A Combined lOCP and MVS Configuration Program Input Stream 
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■x-IOCP 
*IOCP 



UNI 
CNTLUNIT 

UN 
CNTLUNIT 



UN! 
CNTLUNIT 

UNI 
CNTLUNIT 

UN 
CNTLUNIT 

UN 
CNTLUNIT 



ID MSG1='SAMPLE lOCP F 
CHPID PATH=( (00,0,0) ),TYP 
CHPID PATH=( (01 ,1,0) ),TYP 
CHPID PATH=( (02,2,0) ),TYP 
CHPID PATH=( (03,3,0) ),TYP 
CHPID PATH=( (04,U,0)),TYP 
CNTLUNIT CUNUMBR=000, PATH 

UNITADD=( (00,8) ) 
CNTLUNIT CUNUMBR=001,PATH 

UNITADD:^( (08,8) ) 
CNTLUNIT CUNUMBR=002, PATH 

UNITADD=( ( 10,8) ) 
CNTLUNIT CUNUMBR=003, PATH 

UNITADD=( (18,8) ) 
CNTLUNIT CUNUMBR=00U, PATH 

UNITADD=( (30,48)) 
CNTLUNIT CUNUMBR-006, PATH 

UNITADD=( (80,8) ) 
CNTLUNIT CUNUMBR=007, PATH 
TADD=B0 

CUNUMBR=010, PATH 
TADD=( (80,8)) 
CUNUMBR=011, PATH 
UNITADD=( (90,8) ) 
CNTLUNIT CUNUMBR=020,PATH 
ITADD=((00,64)) 
CUNUMBR=^021, PATH 
TADD=( (U0,8) ) 
CUNUMBR=02U, PATH 
ITADD=( (A0,8) ) 
CUNUMBR=025,PATH 
ITADD=( (D0,8) ] 
CUNUMBR=031, PATH 
UNITADD=((30,8)) 
CNTLUNIT CUNUMBR=032, PATH 

UNITADD=( (!i0, 16) ) 
CNTLUNIT CUNUMBR=033, PATH 

UNITADD=( (D0,8) ) 
CNTLUNIT CUNUMBR=034, PATH 

UNITADD-( (i)0,8) ) 
CNTLUNIT CUNUMBR=OUO, PATH 

UNITADD=( (00,64) ) 
CNTLUNIT CUNUMBR=0U1, PATH 

UNITADD=( (40,16) ) 
CNTLUN I T CUNUMBR=0'42, PATH 
ITADD=( (A0,8)) 
ADDRESS=002,UNIT 
ADDRESS=OOC,UNIT 
ADDRESS=OOD,UNIT 
ADDRESS=OOE,UNIT 
ADDRESS=00F,UN1T 
ADDRESS=012,UNIT 
ADDRESS=013,UNIT 
lODEVICE ADDRESS=(018,7), 
DUMMY DEVICE FOR CP ONLY 
lODEVICE ADDRESS=01F,UNIT 
ADDRESS=(030, 16) 
ADDRESS=(040,16) 
ADDRESS=(050,16) 
ADDRESS=080,UNIT 
ADDRESS=OBO,UNIT 
ADDRESS=(180,2), 
ADDRESS=190,UNIT 
ADDRESS=^(200,2), 
ADDRESS=(208,2), 
ADDRESS=(210,U8) 
ADDRESS=(240,8), 
ADDRESS=2A0,UNIT 
ADDRESS=2D0,UNIT 
lODEVICE ADDRESS=(330,8), 
lODEVICE ADDRESS=(350,8), 
ADDRESS=(358,2), 
ADDRESS=3D0,UNIT 
ADDRESS=(410,48) 
ADDRESS=(440,16) 
ADDRESS=UAO,UNIT 



UNI 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 



lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 



lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 
lODEVICE 



ILE' 
E=BY 
E=BL 
E=BL 
E=BL 
E=BL 
=00, SHARED=N, UN I T=381 1 , 

= 00, SHARED=N, UN I T=381 1 , 

= 00, SHARED=N, UN I T=3505, 

= 00, SHARED=N, UN I T=3274, 

=00,SHARED=N,UNIT=3705, 

= 00, SHARED=N, UN I T=2955, 

=00, SHARED=N, UN I T=3705, 

= 01 , SHARED=Y, UN I T=3803, 

01 , SHARED=Y, UN I T=3803, 

= 02, SHARED=N, UN I T=3830, 

02, SHARED=N, UN I T=3830, 

=02,SHARED=N,UNIT=3851, 

=02,SHARED=N,UNIT=2835, 

=03,SHARED=N,UNIT=3830, 

(03,04),SHARED=N,UNIT=3830, 

=03, SHARED=N, UN I T=:CTCA, 

03,SHARED=N,UNIT=3830, 

04, SHARED=N, UN IT=3830, 

04, SHARED=N, UN I T=3880, 

04, SHARED=N, UN I T=3851 , 

3211,CUNUMBR=000 
=2540R,CUNUMBR=001 
=2540P,CUNUMBR=001 
=1403,CUNUMBR=001 
=1403,CUNUMBR=001 
=3505,CUNUMBR=002 
=3525,CUNUMBR=002 
UN I T=3279, M0DEL=3, CUNUMBR=003 

=3215,CUNUMBR=003 

, UN I T=3705, CUNUMBR=004 

,UNIT=3705,CUNUMBR=004 

, UN I T=3705, CUNUMBR=004 

=2955,CUNUMBR=006 

=3705,CUNUMBR=007 

UNIT=3420,MODEL=7,CUNUMBR=010 

=3420, M0DEL=8, CUNUMBR=01 1 

UNIT=3 330,M0DEL=1,CUNUMBR=020 

UN1T=3 330,M0DEL=1,CUNUMBR=020 

, UN I T=33 30, M0DEL=1 , CUNUMBR=020 

UN I T=3 350, CUNUMBR=( 021 , 034 ) 

3851,CUNUMBR=024 
=2305,MODEL=2,CUNUMBR=025 
UNIT=3 330,MODEL=1,CUNUMBR=031 
UNIT=3 330,M0DEL=1,CUNUMBR=032 
UN I T=3 330, M0DEL=1 1 , CUNUMBR=032 
=CTC,CUNUMBR=033,TIMEOUT=N 
,UNIT=33 30,MODEL=1,CUNUMBR=040 
,UNIT=3 380,CUNUMBR=041 
=3851,CUNUMBR=042 



DMK00010 
DMK00020 
DMK00030 
DMK00040 
DMK00050 
DMK00060 

*DMK00070 
DMK00080 

*DMK00090 
DMK00100 

+^DMK00110 
DMK00120 

+^DMK00130 
DMK00140 

*DMK00150 
DMK00160 

•"■DMK00170 
DMK00180 

*DMK00190 
DMK00200 

*DMK00210 
DMK00220 

+<DMK00230 
DMK00240 

^DMK00250 
DMK00260 

«DMK00270 
DMK00280 

*DMK00290 
DMK00300 

■«DMK00310 
DMK00320 

*DMK00330 
DMK00340 

•«-DMK00350 
DMK00360 

«DMK00370 
DMK00380 

*DMK00390 
DMK00400 

•"•DMK00410 
DMK00420 

*DMK00430 
DMK00440 

«DMK00450 
DMK00460 
DMK00470 
DMK00480 
DMK00490 
DMK00500 
DMK00510 
DMK00520 
DMK00530 
DMK00540 
DMK00550 
DMK00560 
DMK00570 
DMK00580 
DMK00590 
DMK00600 
DMK00610 
DMK00620 
DMK00630 
DMK00640 
DMK00650 
DMK00660 
DMK00670 
DMK00680 
DMK00690 
DMK00700 
DMK00710 
DMK00720 
DMK00730 
DMK00740 
DMK00750 
DMK00760 



Figure B-4. lOCP Macro Instruction Input 
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DMKRIO CSECT DMK00010 

RDEVICE ADDRESS=002,DL'VTYPE=32n,CLASS=(X,A), FEATURE=UNVCHSET DMK00020 

RDEVICE ADDRESS=00C,DEVTYPE=25U0R DMK00030 

RDEVICE ADDRESS=00D,DEVTYPE=25U0P,CLAS5=(X,A) DMKOOOUO 

RDEVICE ADDRESS=00E,DEVTYPE=1U03,CLASS=(X,A), FEATURE=UNVCHSET DMK00050 

RDEVICE ADDRESS=OOF, DEVTYPE=1 U03, CLASS=( S ) , FEATURE=UNVCHSET DMK00060 

RDEVICE ADDRESS=012,DEVTYPE=3505 DMK00070 

RDEVICE ADDRESS=013,DEVTYPE=3525,CLASS=(X,A) DMK00080 

RDEVICE ADDRESS=(018,7).DEVTYPE=3279,MODEL=3 DMK00090 

RDEVICE ADDRESS=01F,DEVTYPE==3215 DMK00100 

RDEVICE ADDRESS= (030,1 6 ),DEVTYPE= 3705, ADAPTER=BSCA,BASEADD=OBO DMK00110 

RDEVICE ADDRESS=(0i40, 16 ) , DEVTYPE=3705 , ADAPTER^ I BM1 , BASEADD=0B0 DMK00120 

RDEVICE ADDRESS=(050, 1 6 ) , DEVTYPE=3705, ADAPTER=TELE2, BASEADD=0B0 DMK00130 

RDEVICE ADDRESS=080,DEVTYPE=2955 DMKOOIUO 

RDEVICE ADDRESS=0B0,DEVTYPE=3705, ADAPT ER=TYPEi4, MODEL- F/j,CPTYPE=EP DMK00150 

RDEVICE ADDRESS=( 180,2) ,DEVTYPE=3U20, FEATURE=DUALDENS, M0DEL=7 DMK00160 

RDEVICE ADDRESS=190,DEVTYPE=3420,FEATURE=DUALDENS,M0DEL=8 DMK00170 

^ DEVICE ADDRESSES 200, 201, 208, 209 ALLOW ACCESS TO MSC TABLES DMK00180 

RDEVICE ADDRESS=(200,2),DEVTYPE=3330,MODEL=1 DMK00190 

RDEVICE ADDRESS=(208,2),DEVTYPE=3330,M0DEL=1 DMK00200 

RDEVICE ADDRESS=(210,U8),DEVTYPE=3330,MODEL=1, FEATURE=SYSV I RT DMK00210 

RDEVICE ADDRESS=(2U0,8) ,DEVTYPE=3350,ALTCU=3U0 DMK00220 

RDEVICE ADDRESS=2A0,DEVTYPE=3851 DMK00230 

RDEVICE ADDRESS=2D0,DEVTYPE=2305,MODEL=2 DMK002U0 

RDEVICE ADDRESS=(330,8),DEVTYPE=3330,MODEL=1 DMK00250 

RDEVICE ADDRESS=(350,8),DEVTYPE=3330,MODEL=1 DMK00260 

RDEVICE ADDRESS=(358,2),DEVTYPE=3330,M0DEL=11 DMK00270 

RDEVICE ADDRESS=3D0,DEVTYPE=CTCA DMK00280 

RDEV I CE ADDRESS=( U1 0, l48 ) , DEVTYPE=3 3 30, M0DEL=1 , FEATURE=V I RTUAL DMK00290 

RDEVICE ADDRESS=(U40,16),DEVTYPE=3380 DMK00300 

RDEVICE ADDRESS=UA0,DEVTYPE=3851 DMK00310 

RCTLUNIT ADDRESS=000,CUTYPE=3811 DMK00320 

RCTLUNIT ADDRESS=008,CUTYPE=2821 DMK00330 

RCTLUNIT ADDRESS=010,CUTYPE=3505 DMK003U0 

RCTLUNIT ADDRESS=018,CUTYPE=327U DMK00350 

RCTLUNIT ADDRESS=030,CUTYPE=3705, FEATURE=U8-DEVICE DMK00360 

RCTLUNIT ADDRESS=080,CUTYPE=2955 DMK00370 

RCTLUNIT ADDRESS=0B0,CUTYPE=3705 DMK00380 

RCTLUNIT ADDRESS=180,CUTYPE=3803 DMK00390 

RCTLUNIT ADDRESS=190,CUTYPE=3803 DMKOOMOO 

RCTLUNIT ADDRESS=200,CUTYPE=3830, FEATURE=64-DEVICE DMK00U10 

RCTLUNIT ADDRESS=2U0,CUTYPE=3830 DMK00i420 

RCTLUNIT ADDRESS=2A0,CUTYPE=3851 DMK00430 

RCTLUNIT ADDRESS=2D0,CUTYPE=2835 DMKOOUUO 

RCTLUNIT ADDRESS=330,CUTYPE=3830 DMK00U50 

RCTLUNIT ADDRESS=340,CUTYPE=3830 DMK00U60 

RCTLUNIT ADDRESS=350,CUTYPE=3830, FEATURE=16-DEV I CE, ALTCH=4 DMK00470 

RCTLUNIT ADDRESS=3D0,CUTYPE=CTCA DMK00U80 

RCTLUNIT ADDRESS=U00,CUTYPE=3830, FEATURE=64-DEVICE DMK00490 

RCTLUNIT ADDRESS=i|40,CUTYPE=3880, FEATURE=16-DEVICE DMK00500 

RCTLUNIT ADDRESS=UA0,CUTYPE=3851 DMK00510 

RCHANNEL ADDRESS=0, CHTYPE=MULT I PLEXOR DMK00520 

RCHANNEL ADDRESS=1 , CHTYPE=SELECTOR DMK00530 

RCHANNEL ADDRESS=2, CHTYPE=BLKMPXR DMK005U0 

RCHANNEL ADDRESS=3 , CHTYPE=BLKMPXR DMK00550 

RCHANNEL ADDRESS=U, CHTYPE=BLKMPXR DMK00560 

RIOGEN CONS=01F,ALTCONS=018 DMK00570 

END DMK00580 

Figure B-5. DMKRIO File for VM/SP and VM/SP HPO System Generation 
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RIO TITLE 'SAMPLE HCPRIO ASSEMBLE FILE' 

RDEV I CE DEVN0=002, DEVTYPE=321 1 , CLASS= ( X, A) , FEATURE=UNVCHSET HCP00020 

RDEVICE DEVNO=OOC,DEVTYPE=25i40R HCP00030 

RDEVICE DEVNO=00D,DEVTYPE=25U0P,CLASS=(X,A) HCPOOOUO 

RDEVICE DEVNO=OOE,DEVTYPE=1403,CLASS=(X,A),FEATURE=UNVCHSET HCP00050 

RDEVICE DEVN0=00F,DEVTYPE=1i|03,CLASS=(S), FEATURE=UNVCHSET HCP00060 

RDEVICE DEVNO=012,DEVTYPE=3505 HCP00070 

RDEVICE DEVN0=013,DEVTYPE=3525,CLASS=(X,A) HCP00080 

RDEVICE DEVNO=(018,7),DEVTYPE=3279,MODEL=3 HCP00090 

* VM/XA MIGRATION AID DOES NOT SUPPORT 3215 HCP00100 

* THE PRIMARY CONSOLE WILL BE A 3279 INSTEAD HCP00110 

* RDEVICE DEVNO=01F,DEVTYPE=3215 HCP00120 
RDEVI CE DEVNO=( 030, 16 ) , DEVTYPE=3705, ADAPTER=BSCA, BASEADD==OBO HCP001 30 
RDEVICE DEVNO=(0U0,16),DEVTYPE=3705,ADAPTER=IBMl,BASEADD=0B0 HCPOOmO 
RDEVICE DEVNO=(050, 16),DEVTYPE=3705,ADAPTER=TELE2,BASEADD=0B0 HCP00150 

* VM/XA MIGRATION AID DOES NOT SUPPORT 2955 HCP00160 

* RDEVICE DEVNO=080,DEVTYPE=2955 HCP00170 
RDEVICE DEVNO=0B0,DEVTYPE=3705,ADAPTER=TYPEU, XHCP00180 

M0DEL=F4,CPNAME=E HCP00190 

RDEVICE DEVNO=( 180,2), DEVTYPE=3'420, FEATURE=DUALDENS,M0DEL=7 HCP00200 

RDEVICE DEVNO=190,DEVTYPE=3U20, FEATURE=DUALDENS,M0DEL=8 HCP00210 

* DEVICES 200, 201, 208, 209 ALLOW ACCESS TO MSC TABLES HCP00220 

RDEVICE DEVNO=(200,2),DEVTYPE=3330,MODEL=1 HCP00230 

RDEVICE DEVNO=(208,2),DEVTYPE=3330,MODEL=1 HCP002U0 

RDEVICE DEVNO=(210,U8),DEVTYPE=3330, FEATURE=VUA HCP00250 

RDEVICE DEVNO=(2U0,8),DEVTYPE=3350 HCP00260 

RDEVICE DEVNO=2A0,DEVTYPE=3851 HCP00270 

RDEVICE DEVNO=2D0,DEVTYPE=2305,MODEL=2 HCP00280 

RDEVICE DEVN0=( 330,8), DEVTYPE=3330,MODEL=1 HCP00290 

RDEVICE DEVNO=(350,8),DEVTYPE=3330,MODEL=1 HCP00300 

RDEVICE DEVNO=(358,2),DEVTYPE=3330,MODEL=11 HCP00310 

RDEVICE DEVNO=3D0,DEVTYPE=CTCA HCP00320 

RDEVICE DEVNO=(410,U8),DEVTYPE=3330, FEATURE=VUA HCP00330 

RDEVICE DEVNO=(f4U0,16),DEVTYPE=3380 HCP003i40 

RDEVICE DEVNO=UA0,DEVTYPE=3851 HCP00350 

* THE PRIMARY CONSOLE IS A 3279-3, NOT A 3215 HCP00360 

RIOGEN CONS=018,ALTCONS=019 HCP00370 

END HCP00380 

Figure B-6. HCPRIO File for VM/XA Systems Facility 
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Appendix C. Characteristics of the I/O Interface Timeout 
Function 

On the processor complex, each channel path has an eight-second I/O interface 
timeout function that times the control unit delays in completing I/O tag sequences 
and delays that occur between dependent tag sequences. For additional information 
about these tag sequences, see IBM System/360 and System/370 I/O Interface 
Channel to Control Unit Original Equipment Manufacturer's Information, GA22-6974. 

Malfunctions in control units and I/O devices can cause a channel path to be 
unusable to other control units and I/O devices. The timeout function detects these 
malfunctions. 

When the timeout function is active, any control unit delay in completing an I/O tag 
sequence that exceeds eight seconds or a delay between one sequence and the next 
dependent sequence that exceeds eight seconds results in the channel terminating the 
I/O request to the control unit and generating an interface-control-check 
interruption. For example, the timeout function times the delay between two tag 
sequences used to transfer data between the channel and the control unit. 

When the timeout function is inactive (timeout is inhibited), control unit delays are 
not timed and the channel unconditionally waits until the control unit completes the 
sequence or initiates the next tag sequence. If the control unit fails to complete a 
sequence because of a malfunction, the channel path remains active to the control 
unit. In this case, the channel path is unusable for I/O requests to other control 
units until the failing control unit drops all in-tags (except metering-in and 
request-in) or the channel path is reset. 

You specify whether the timeout function is to be active or inactive with the 
TIMEOUT parameter, which you specify on the lODEVICE macro instruction or 
the add or alter I/O device screen. 

Note: The TIMEOUT parameter has no effect on delays between channel end and 
device end status presentations when the channel is operating in 370 selector mode. 
The I/O interface timeout function is always inactive during that time. 

The channel times I/O requests as follows: 

• If TIMEOUT = Y is specified, the I/O interface timeout function is active and 
the channel times all I/O tag sequences and delays between dependent tag 
sequences that are initiated by either the channel or the control unit. Some 
examples are: the initial selection sequence resulting from an SIO or SIOF 
instruction, a request-in tag sequence initiated by the control unit to reconnect 
to the I/O interface, and delays between data transfer tag sequences. 

• If TIMEOUT = N is specified, the I/O interface timeout function is inactive 
(timeout is inhibited) for: 

— Data transfer tag sequences 

— Delays between data transfer tag sequences 

— Non-reconnect ending status tag sequences 

— Initial selection sequences due to non-reconnect command chaining 

When the timeout function is inactive, these delays are not timed and the 
channel waits until the I/O device completes the tag sequence or initiates the 
next dependent sequence. 
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When TIMEOUT = N is specified, the I/O interface timeout function is still 
active for: 

- Selection sequences initiated by the control unit 

- Initial selection sequences for the first command after reconnect command 
chaining 

- Any initial selection sequence (such as the SIO, RIO, or TIO instructions) 
when the device is not connected 

Some examples showing when the timeout function is inactive if TIMEOUT = N is 
specified are: 

Example A. Channel initiated sequence (e.g. SIO) 



Initial Data 

selection transfer 

sequence sequences 



Ending status: 
channel end and 
device end sequence 



<---Timed---> < 

Status-in 



-Not timed- 



Example B. Command chaining control unit initiated reconnection sequence 



Device end Initial Data Ending status: 

reconnect selection transfer channel end and 
sequence sequence sequences device end sequence 



-Timed- 



■Not timed- 



Status-in 



Example C. Split channel end and device end sequence 

^ : 



Ending status: Ending status: 

channel end <-Delay interval -> device end 
sequence sequence 



-Not timed if channel is operating- 
in selector mode 
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When a timeout condition is detected, the channel terminates the I/O request to the 
control unit by issuing a selective reset to the control unit and then generating an 
interface-control-check interruption. In 370 mode, if the control unit fails to 
respond to the selective reset and does not drop all in-tags (except metering-in and 
request-in) to the I/O interface within 16 microseconds, the limited channel logout 
that accompanies the interface-control-check indicates an interface-inoperative 
condition. In 370-XA mode, a channel report word (CRW) is made pending which 
indicates a channel-path-terminal condition. 

If TIMEOUT ==N is specified then detection of a timeout condition as a result of an 
interface associated malfunction may not occur ( see the beginning of this appendix 
for a description of sequences which are not timed when TIMEOUT = N is 
specified.) Failure to detect and recover this condition may make various resources 
unavailable to the control program. If continued operation is dependent on the 
availabiUty of these resources, system degradation may be experienced until those 
resources are recovered. Recovery may occur as a consequence of detecting a 
secondary error the 308X may develop from faihng to detect the timeout condition. 
Generally, this will not occur and recovery of the resources will require operator 
intervention. For these reasons TIMEOUT = N should be coded only when you 
decide there is a real need which justifies the exposure. 

Timeout Considerations 

Some control units and I/O devices have valid operational conditions that exceed the 
eight-second timeout function limit. If timeout is active when such a condition 
occurs, the channel terminates the I/O request and generates an 
interface-control-check interruption, even though no malfunction exists. For 
example: 

• A timeout might occur during a read operation to a tape unit if the tape being 
read is blank. While the tape unit searches for a data byte or the end-of-tape 
mark, it might exceed the eight-second timeout function Hmit. 

• A channel-to-channel adapter between two systems might time out if one system 
attempts to communicate with the other system while the other system is in a 
stopped state. 

Thus, when timeout is active, the channel might terminate an I/O request and 
generate an interface-control-check interruption even though no control unit or I/O 
device malfunction has occurred. 

Note: For a device that can exceed eight seconds with vaUd operational conditions, 
inhibit the timeout function by specifying TIMEOUT = N on the lODEVICE macro 
instruction. For other IBM I/O devices, it is recommended that you specify or use 
the default TIMEOUT = Y. However, you may chose to specify TIMEOUT = N. 
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Appendix D. List of I/O Devices and Control Units 



Note: Figure D-1 is a sample list of possible I/O devices. It is not intended to be a 
list of all the possible I/O devices. 

Figure D-1 provides a sample list of I/O devices and shows the keyword values you 
specify for the UNIT, MODEL, and TIMEOUT keywords on the lODEVICE 
macro instruction. 

Note: The list does not include all devices that support the 308x processor complex. 
Also, the figure lists the control units that attach the I/O devices and shows the 
keyword values you specify for the UNIT, SHARED, and PROTOCL keywords on 
the CNTLUNIT macro instruction. Notes, which are referenced in the Ust of 
devices and control units, contain additional information for specific I/O devices and 
control units. 

See "Specifying lOCP Macro Instructions" in Chapter 2 (MVS) or Chapter 3 (VM) 
for a full description of the lODEVICE and CNTLUNIT macro instructions and the 
meanings of the keyword values shown in Figure D-1. 

If you are coding the lODEVICE macro instruction for use with an MVS system 
generation, see 0S/VS2 System Programming Library: System Generation Reference 
or MVS/ Extended Architecture System Generation Reference for a full description of 
the non-IOCP parameters on the lODEVICE macro instruction. You should also 
refer to this book for the correct keyword value for the UNIT keyword when you 
are using a common deck. If you are coding the lODEVICE macro instruction for 
use with an MVS Configuration Program, see MVS /Extended Architecture: MVS 
Configuration Program Guide and Reference 

See IBM System/ 370 Input /Output Configurator for information about the 
attachment of I/O equipment used in System/370. 

General Notes: 

1 . Devices that are supported by lOCP are not necessarily supported by your 
operating system. 

2. On processor complex (such as the 3084 Processor Complex) that you have 
partitioned, if a control unit is attached to multiple channel paths and the 
channel paths are divided between the A side and the B side, the "MULTITAG" 
switch (if the control unit has one) must be set to the on position. 

3. If you use the UNIT ADD keyword on the lODEVICE macro instruction, you 
must follow the same rules and restrictions that apply to the second and third 
digits of the ADDRESS parameter. 
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4. If you specify the UNIT ADD parameter on the lODEVICE macro instruction, 
then the second and third digits of the ADDRESS parameter can be different 
from the device's physical unit address (except for the 3344, 3330V, 3 3 SOP, and 
3351P direct access devices) if you follow these rules: 

• All device rules for addressing must be followed. 

• For magnetic tapes and local display devices, all device numbers on a 
control unit must be consecutive and the lowest device number must be 
moduloi to the number of devices that can be attached to the control unit. 

• For direct access devices: 

- Device numbers on a string must be consecutive (except for the 3344). 

- The lowest device number on a string of 3330s (and 3350s in emulation 
mode) must be modulo^ to the maximum string size. 



lODEVICE Macro Instruction 
)NIT= MODEL= TIMEOUT= Notes 
Di rect Access Devices 



CNTLUNIT Macro Instruction 
IIT= Model SHARED= PROTOCL= Notes 



2305 


2 


Y 


1 


2835 


2 


N 


D 


2 


333G 


1,2,11 


Y 


3,4 


3830 
3880 


2 

1,2,11 


N 
N 


D 
D/S 


5,6 


3330V 


- 


Y 


8 


3830 


3 


N 


D 


8 


3350V 


- 


Y 


8,8a 


3830 


3 


N 


D 


8 


3333 


1,11 


Y 


7 


3830 
3880 


2 
1,2,11 


N 
N 


D 
D/S 


5,6 


3340 


- 


Y 


4,9 


3830 
3880 


2 

1,2 


N 
N 


D 
D/S 


5,6 


3344 


- 


Y 


9,10 


3830 
3880 


2 
1,2 


N 
N 


D 
D/S 


5,6 


3350 


- 


Y 


4,9,11 


3830 
3880 


2 
1,2,11 


N 
N 


D 
D/S 


5,5 


3350P 


- 


Y 


4,9,11 


3880 


11 


N 


D/S 


5,6,12 


3351P 


- 


Y 


4,14 


3880 


21 


N 


D/S 


5,6,15 


3375 


- 


Y 


9 


3880 


1,2 


N 


D/S 


5,6 


3380 




Y 


9 


3880 
3880 
3880 
388G 


2,3 
2,3 
13 
23 


N 
N 
N 
N 


D 
S 
S 
S 


5,6,13 
5,6 
5 
5 


3390 


- 


Y 


9,15a 


3990 


2,3 


N 


S4 
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1 Modulo means that the device number must be evenly divisible by the number of devices in hexadecimal. For 
example, if there are 16 (10 in hex) devices, the last digit of the device number must be 0. If there are 4 devices, the 
last digit must be 0, 4, 8, or C. 
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NOTES: 

l.For the 23G5, specify ADDRESS=(aaa,8) . lOCP unconditionally assigns eight 

addresses for the device. 

2. For the 2835, specify UNITADD=((aa,n)) , where n=8 or 16 depending on the 

number of 2305 unit addresses required. 

3.* Specify the 333G Model 2 as M0DEL=1. (Note that the 3330 attaches to the 

3830 via the 3333.) 

4.* On the ADDRESS parameter, if you do not specify the number of sequential 

device addresses to be assigned, a default of 2 is used. For the 3350P or 3351P, 

lOCP unconditionally assigns two base addresses if the user specifies 

none or 1. For the 3351P, lOCP unconditionally assigns four base addresses 

if the user specifies 3. 

5. For the 3880, one CNTLUNIT macro instruction must be specified for each 

3880 Storage Director. 

6. Each channel path attaching to the 3880 Model 1, 2, 3, or 11 can operate 

independently in either data streaming mode or offset interlock mode. 

The 3880 has eight channel speed control switches for setting the mode of 

operation. Regardless of the device types attached to the 3880, it is 

recommended that the user: 

(a) set all 3880 channel speed control switches for channel paths attached 
to the processor complex to data streaming mode; 

(b) specify PR0T0CL=S on the CNTLUNIT macro instructions for each 3880 
storage director. 

These actions allow the maximum data transfer rates and the use of 
longer cable lengths. The processor complex requires all control units 
attaching a common device to the processor complex to use the same 
interface protocol. Therefore, when both a 3880 and a 3830 attach a 
common device to the processor complex, the user must specify PR0T0CL=D 
on both 

(a) the CNTLUNIT macro instruction for the 3830 storage director, and 

(b) the CNTLUNIT macro instruction (s) for the attached 3880 storage director(s). 
In this case, you must set the 3880 channel speed control switches for the 
channel paths that attach the 3880 storage director(s) to the non-data 
streaming mode. 

7.* Specify the 3333 as UNIT=3330. 

8. For the 3330V (virtual volume for MSS), you must also specify the 3851 

on an lODEVICE macro instruction. See the entry for 3851 under "Control Units". 

8a.* For virtual volumes for MSS using 3350 devices as staging devices, specify 

UNIT=3330V. 

* Indicates that the note applies only when you are specifying the lODEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and lOCP macro 
instructions. 
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9.* Do not specify the MODEL parameter if the lODEVICE macro instruction is to be 

used as input to MVS system generation. 

IQ.* Specify the 3344 as UNIT=3340. 

11. Specify UNIT=3350P for each 3350 that is attached to the paging storage 

of a 3880 Model 11. For each 3350P, lOCP defines four device addresses. 

lOCP takes the base address from the ADDRESS parameter. lOCP forms three 

additional addresses by adding the decimal values 8, 16, and 24 to the base 

address. The base address (xyz) must be specified correctly. Bits 3 and 4 of the 

binary values of the byte representing the last two digits of the base 

address must be zeroes. 

(The binary value of the base address xyz must be of the form "nnnn nnnO Onnn".) 

Thus, y must be an even hexadecimal digit (0, 2, 4, 6, 8, A, C, or E) and 

z must be in the range of through 7. Specify UNIT=3350 for each 3350 

that is attached to the non-paging storage director of a 3880 Model 11, 

to a 3880 Model 1 or 2, or to a 3830. 

12. Specify the paging storage director of a 3880 Model 11 as UNIT=3880P. 

Also, specify UNITADD=((aa,32)) . Bits 3 through 7 of the binary value of 

the byte representing aa must be zeroes. Specify the non-paging storage director 

of a 3880 Model 11 as UNIT=3880. 

13. The 3880 Speed Matching Buffer feature is required. 

14. Specify UNIT=3351P for each 3350 that is attached to the paging storage 

director of a 3880 Model 21. For each 3351P, lOCP defines four device addresses. 

lOCP takes the base address from the ADDRESS parameter. lOCP forms three 

additional addresses by adding the decimal values 4, 8, and 12 to the base 

address. The base address (xyz) must be specified correctly. Bits 4 and 5 of the 

binary value of the byte representing the last two digits of the base address 

must be zeroes. (The binary value of the base address xyz must be of the 

form "nnnn nnnn OOnn".) Thus z must be in the range of through 3. 

15. Specify the paging storage director of a 3880 Model 21 as UNIT=3880P. 

Also, specify UNITADD=((aa,32)) . 

Bits 3 through 7 of the binary value of the byte representing aa must be 

zeroes. 

15a. The unit type should indicate the mode of operation for the device. 

If the device is set to 3380 track compatibility mode, use UNIT=3380. 

* Indicates that the note applies only when you are specifying the lODEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and lOCP macro 
instructions. 
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lODEVICE Macro Instruction 
UNIT= MODEL= TIMEOUT= Notes 
Display Devices 



CNTLUNIT Macro Instruction 
IIT= Model SHARED= PROTOCL= Notes 



2250 


3 


Y 


- 


2840 


2 


Y 


D 


- 


3250 


- 


Y 


16 


3258 


- 


YB 


D 


- 


3262 


3,13 


Y 


17 


3272 


1,2 


N,YB 


D 


18 










3274 


1B,21B, 
21D,31D 


N,YB 


D 


19 


3277 


1,2 


Y 


- 


3272 


1,2 


N,YB 


D 


18 










3274 


1B,21B, 

1D,21D 

31D 


N,YB 


D 


19 


3278 


- 


Y 


- 


3272 


1,2 


N,YB 


D 


18 










3274 


1B,21B, 

1D,21D 

31D 


N,YB 


D 


19 


3279 


2A.2B, 
3A,3B 


Y 




3274 


1B,21B, 
1D,21D, 
31D 


N,YB 


D 


19 


3284 


1,2 


Y 




3272 


1,2 


N,YB 


D 


18 










3274 


1B,21B, 

1D,21D 

31D 


N,YB 


D 


19 


3286 


1,2 


Y 




3272 


1,2 


N,YB 


D 


18 










3274 


1B,21B, 

1D,21D 

31D 


N,YB 


D 


19 


3287 


i,ic, 


Y 


17,20 


3272 


1,2 


N,YB 


D 


18 




2,2C 






3274 


1B,21B, 

1D,21D 

31D 


N,YB 


D 


19 


3288 


2 


Y 


17 


3272 


1,2 


N,YB 


D 


18 










3274 


1B,21B, 

1D,21D 

31D 


N,YB 


D 


19 


3289 


1,2 


Y 


17 


3272 


1 ? 


N,YB 


D 


18 










3274 


1B,21B, 

1D,21D 

31D 


N,YB 


D 


19 
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NOTES: 

16.* Specify the 3250 as UNIT=2250,M0DEL=3. 

17.* Specify the 3262, 3287, 3288, and 3289 as UNIT=3284 or UNIT=3286. 

If the 3287, 3288, or 3289 will be used as an MVS/XA operator's console, 

specify UNIT=3286,M0DEL=2. 

18. For a 3272 attached to a block multiplexer channel path, the recommended 

specification is SHARED=YB if multiple devices are attached to the control 

unit. SHARED=N is required if a 3272 is attached to a byte multiplexer 

channel path. If SHARED=N is specified and multiple devices are attached 

to the control unit, special error recovery program (ERP) processing is 

required for possible zero sense data. (See IBM 3271 Control Unit, 

3272 Control Unit, 3275 Display Station Description and Programmer's 

Guide, GA23-0O6G.) Also, this increases the possibility of additional 

overhead in the control program resulting from deferred condition code 1 I/O 

interruptions. If a single device is attached to the control unit, 

SHARED=N can be specified without special ERP support and without increasing 

the overhead in the control program for interruption processing. 

19. For a 3274 attached to a block multiplexer channel path, the recommended 

specification is SHARED=YB if multiple devices are attached to the control unit. 

If necessary, you can specify SHARED=N when multiple devices are attached 

to the control unit. (For 370 mode, specify SHARED=N for the control uni 

that interfaces with the master and alternate consoles.) However, specifying 

SHARED=N increases the possibility of additional overhead in the control 

program resulting from deferred condition code 1 I/O interruptions. If a 

single device is attached to the control unit (as is always the case for 

the 3274 Model lA) , SHARED=N can be specified and does not increase the 

overhead in the control program for interruption processing. If a single 

device is attached to the control unit (as is always the case for the 3274 

Model lA), SHARED=N can be specified and does not increase the overhead in the 

control program for interruption processing. 

20.* Specify the Model IC as Model 1; Model 2C, as Model 2. 

21. If the magnetic tape subsystem contains 2 to 4 control units that access the 

same group of magnetic tape units, define each control unit separately. 

Each of the control units must have a different channel path identifier, 

but all of the control units should specify the same address range. 

Specify on the lODEVICE macro instruction that the tape units are attached to all 

of the control units. (The tape units may actually be only logically 

attached, but they are specified as though they are physically attached.) 

22.* Specify the 2540 with two lODEVICE macro instructions: one with 

UNIT=2540R, the other with UNIT=2540P. 

23.* For the 3203, only the Model 5 is supported, but you specify the Model 5 as 

M0DEL=4. 

* Indicates that the note applies only when you are specifying the lODEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and lOCP macro 
instructions. 



Figure D-1 (Part 5 of 7). lOCP Parameter Values for lODEVICE and CNTLUNIT Macro Instructions 



D-6 lOCP User's Guide and Reference 



lODEVICE Macro Instruction 



IIT= MODEL= TIMEOUT= Notes 



CNTLUNIT Macro Instruction 



IIT= Model SHARED= PR0TOCL= Notes 



Magnetic 


Tapes 
















3420 


3,4 
6,7 


,5, 
,8 


Y 


21 


3803 


1,2 


Y 


D 


21 


3480 


- 




Y 


- 


3480 


- 


N 


S 


- 


Magnetic 


Ink 


Character 


Readers 












3890 


A,B 




Y 


- 


3890 


A,B 


N 


D 


- 


Unit Record 


Devices 














1403 


Nl, 
N7 


N2, 


Y 


- 


2821 


1,2,3,5 


N 


D 


- 


2501 


Bl, 


B2 


Y 


- 


2501 


B1,B2 


N 


C 


- 


2540 


1 




Y 


22 


2821 


1,4,5,6 


N 


D 


- 


3203 


5 




Y 


23 


3203 


4 


N 


D 


- 


3211 


- 




Y 


24 


3811 


1 


N 


D 


- 


3505 


- 




Y 


24 


3505 


B1,B2 


N 


D 


- 


3525 


- 




Y 


24 


3505 


B1,B2 


N 


D 


- 


3540 


- 




Y 


24 


3540 


B1,B2 


N 


D 


- 


3800 


- 




Y 


25,34, 


3800 


1,2,3 


N 


D/S 


- 


4245 


- 




Y 


- 


4245 


- 


N 


D 


- 


4248 


- 




Y 


- 


4248 


- 


N 


D 


- 


Control 


Uni 


ts 
















3851 


- 




Y 


24,28 


3851 


all 


N 


D 


28 


Others 




















„ CTC 


- 




Y 


29 


CTC 


- 


N 


D 


- 


3088 


- 




Y 


32 


3G88 


1,2 


N 


D/S 


33 


3174 


- 




Y 


37 


3174 


- 


N 


- 


37 


3838 


- 




Y 


24,26 


3838 


1,2,3 


N 


D/S 


27 


3848 


- 




Y 


24 


3848 


1 


N 


D/S 


- 


Series/1 - 




Y 


- 


Series 


/I - 


N 


D 


- 


Telecommunications 














uuuuu 


- 




Y 


30 


2701 


1 


N 


D 


- 


3704 


- 




Y 


24 


3704 


all 


N 


D 


- 


uuuuu 


- 




Y 


31 


3704 


all 


N 


D 


- 


3705 


- 




Y 


24 


3705 


all 


N 


D 


- 


uuuuu 


- 




Y 


31 


3705 


all 


N 


D 


- 


3725 


- 




Y 


24 


3725 


- 


N 


D 


- 


uuuuu 


- 




Y 


31 


3725 


- 


N 


D 


- 


3791L 


- 




Y 


24 


3791L 


1,2 


N 


D 


- 


Graphics System 
















5081 


- 




Y 


35 


5088 




N 


D/S 


36 
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NOTES: 

24.* Do not specify the MODEL parameter if the lODEVICE macro instruction is to 

be used as input to MVS system generation. 

25. Specify TIMEOUT=Y when IBM-supplied programs are used with the 3800. 

Non-IBM programs might require TIMEOUT=N for the 3800 because I/O requests 

might require more than eight seconds to complete. 

26. For the 3838, specify ADDRESS=(aaO,8) . The last digit of the unit 

address must be 0; and lOCP unconditionally assigns eight unit addresses 

to the device. 

27. For the 3838, specify UNITADD=((aO,8)) . (Note 24 contains related 

information.) 

28. For the 3330V (virtual volume for MSS), you must also specify the 3851 

on an lODEVICE macro instruction. See the entry for 3851 under "Control Units". 

29. For the channel-to-channel adapter (CTC), you may choose to specify TIMEOUT=N 

because I/O sequences on the CTC might require more than eight seconds to 

complete. Because TIMEOUT=N, the CTC cannot be attached to a byte multiplexer 

channel path. 

30.* On the UNIT parameter, you can specify any device or line that is 

attached to the 2701. 

31.* On the UNIT parameter, you can specify any device or line that is 

attached to the 3704,3705 and 3725. (This applies only to EP mode and 

byte multiplexer mode.) 

32. For a 3088, specify ADDRESS=(aaO,n) , where n=32 or 64 depending on the 

number of unit addresses required. 

33. For a 3088, specify UNITADD=(aG,n) , where n=32 or 64 depending on the 

number of unit addresses required. Note 32 contains related information. 

34. Attach the 3800 to a block multiplexer channel (TYPE=BL) for optimum 

system performance. 

35. If you are using one combined input deck, the UNIT parameter must be 

respecified. When you are using the 5081 in a 3250-compatibility mode 

(for example when attached to a 3258), specify the 5081 as UNIT=2250, 

M0DEL=3. When you are using the 5081 in full function mode, specify the 

5081 as UNIT=HFGD. (For more information, see Graphics Access Method/System 

Product: Initialization, Resource Definition, and Customization, SC33-0141-0.) 

36. The 5088 device can run in either D.C. interlock protocol or data streaming 

protocol, depending on the channel. Ensure that the interface protocol 

specified matches the protocol specified in the 5088. 

37. A 3174 with the token ring feature requires, during IPL, an address that 

ends with "0." 

* Indicates that the note applies only when you are specifying the lODEVICE 
macro instruction for use with an MVS system generation, where the input deck 
contains both MVS system generation macro instructions and lOCP macro 
instructions. 
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Glossary 



The following terms are defined as they are used in this 
book. If you do not find the term you are looking for, 
refer to the Index or to the Vocabulary for Data 
Processing, Telecommunications, and Office Systems, 
GC20-1699. 

chaanel path. A connection between a processor and 
control unit along which signals and data can be sent to 
perform I/O requests. Analogous to channel. 

channel set. A collection of channels that can be 
addressed by one of the processors of a processor 
complex. 



data streaming. The I/O interface protocol that 
operates at the rate governed by the control unit, 
protocol does not require the demand response. 
(See D. C. interlock.) 



This 



D. C. interlock. The I/O interface protocol that is the 
standard I/O interface and requires a demand response. 

device address. Three hexadecimal digits that uniquely 
identify an I/O device in 370 mode. 

device number. Three hexadecimal digits that uniquely 
identify an I/O device in 370-XA mode. 

i/O configuration. The collection of channel paths, 
control units, and I/O devices that attaches to the 
processor complex. 



I/O engine. An integrated unit of hardware (consisting 
of one channel processing element, one to three data 
server elements, and 8, 16, or 24 interface adapter 
elements) that performs the I/O operations to all 
attached I/O devices. Note: There are two I/O engines 
in a 3084 Processor Complex. 

input/output configuration data set (lOCDS). The data 
set, located in the processor controller file, that contains 
the I/O configuration definition. 

input/output configuration program (lOCP). An 

IBM -supplied program that creates the I/O 
configuration definition (lOCDS) based on user-defined 
input. 

lOCDS. Input/output configuration data set. 

lOCP. Input/output configuration program. 

logical control unit. A logical representation of (1) a 
control unit that does not share devices, or (2) two to 
four control units that do share devices. 

uniprocessor. A processor complex that physically 
contains only one processor. 

unit address. The last two digits of a device address or 
a device number. 
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Index 



A 

A keyword 

on REPORT option 2-29 
AB keyword 

on REPORT option 2-29 
ABx keyword 

on WRTCDS option 2-26 
add channel path menu 4-15 
add control unit menu 4-18 
add I/O device menu 4-21 
ADD screen command 4-6 
add selection menu 4-11 
ADDRESS keyword 

on lODEVICE macro instruction 2-17, 3-11 
ADD = value screen command 4-6 
alter channel path menu 4-16 
alter control unit menu 4-19 
alter I/O device menu 4-22 
ALTER screen command 4-6 
alter selection menu 4-12 
ALTER = value screen command 4-6 
authorized IOC? program 2-32, 2-33, 2-34 
Ax keyword 

on REPORT option 2-29 

on WRTCDS option 2-26 

B 

B keyword 

on REPORT option 2-29 
BL keyword value 2-8, 3-10 
block multiplexer channel 2-8, 3-10 
BOTH keyword 

on REPORT option 2-29 
BOTHRPT option on lOCP command 3-35 
build lOCDS from cards menu 4-23 
burst mode 2-8, 3-10 
Bx keyword 

on REPORT option 2-29 

on WRTCDS option 2-26 
BY keyword value 2-8, 3-10 
byte multiplexer channel 2-8, 3-10 
byte-interleave mode 2-8, 3-10 

C 

card-image input 

introduction 1-4 

lOCP macro instructions 2-2 
CDO keyword 

on REPORT option 2-29 
CDORPT option on lOCP command 3-35 



CDl keyword 

on REPORT option 2-29 
CDIRPT option on lOCP command 3-35 
CE 1-6,2-33,3-47,4-32 
CHANNEL macro instruction 1-19,2-6 
channel number 2-7, 3-8 
channel path 

alter menu 4-16 
channel path display 4-14 
channel path selection 

for 370-XA mode 1-13,1-14 

on a 3084 Processor Complex 1-14 

preferred path 1-13 

rotation algorithm 1-14 
channel paths 

add menu 4-15 

configuration report 5-5, 5-14 

corresponding side (A or B) 1-1 

delete menu 4-13 

display menu 4-14 

introduction l-l 

specifying on CHPID macro instruction 2-6, 3-8 

summary of restrictions 2-4, 3-6 
channel set 2-7, 3-9 
channel set switching 2-8, 3-10 
channel subsystem 1-1 
CHPID macro instruction 

correspondence with DM K RIO file 3-3 

correspondence with HCPRIO file 3-5 

description 2-6, 3-8 

examples 2-8, 3-10 

for 370-XA mode 1-6 

format 2-6, 3-8 

introduction 1-4 

with MVS system generation 1-19 
chpid number 2-6, 3-8 
CMS/DOS 3-37 
CNTLUNIT macro instruction 

correspondence with DMKRIO file 3-3 

correspondence with HCPRIO file 3-5 

description 2-10,3-11 

examples 2-14, 3-16 

format 2-10,3-11 

introduction 1 -4 

keyword values D-1 

logical control units 2-10, 3-11 

with MVS system generation 1-19 
codes 

return 2-31,3-46 

wait state 4-38 
commands, screen 4-6 

command = value form of screen command 4-6 
comment cards, lOCP 2-2, 2-24, 3-2, A-1 
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compatibility considerations 1-7 
configuration data 

initially defining 2-32, 3-47 

introduction 1-1 

specifying 1 -4, 2-2 

subsequently defining 2-33, 3-48 

updating 2-33, 3-48, 4-33 
configuration reports 

conditions for producing 5-2 

description 5-1 

examples 5-5,5-8,5-11,5-14 

heading, ID macro instruction 2-15, 3-17 

JCL example 2-28 

menu screen 4-25 

producing 2-1,2-28,3-30,3-31 
control unit display menu 4-17 
control unit types 1-17 
control units 

add menu 4-18 

alter menu 4-19 

delete menu 4-13 

display menu 4-17 

introduction 1-1 

specifying on CNTLUNIT macro instruction 2-10, 
3-11, D-1 

specifying on lODEVICE macro instruction D-1 
CUNUMBR keyword 3-20 

specifying on the lODEVICE macro instruction 
on CUNUMBR parameter 2-18 

summary of restrictions 2-4, 3-6 

types 1-17 
CUNUMBR keyword 

on CNTLUNIT macro instruction 2-10. 3-1 1 

on lODEVICE macro instruction 2-18, 3-20 
customer name for the lOCDS 2-15, 3-17, 4-30 



DISPLAY = value screen command 4-7 

DMKRIO file 3-3 

DMSICP module 3-30 

DSE (data server element) 1-2, 1-3, 2-4, 3-6 

dumping lOCP storage 4-36 

D. C. interlock protocol 

on PROTOCL = D parameter 3-12 
D.C. interlock protocol 

on PROTOCL = D parameter 2- 1 1 



end lOCP menu 4-31 
END screen command 4-7 
executing lOCP 

MVS version 1-18,2-1 
stand-alone version 1-25, 4-1 
VM version 1-23,3-1 



FILEDEF command 3-32 

fileid 3-32 

for 370-XA mode 

channel path selection 

rotation algorithm 1-14 
format of macro instruction 

CHPID 2-6 

lODEVICE 3-18 
format of macro instructions 

CHPID 3-8 

CNTLUNIT 2-10,3-11 

ID 2-15,3-17 

lODEVICE 2-16 

rules for coding A-1 



D 

D keyword 

on PROTOCL keyword 2-1 1 
D keyword value 

on PROTOCL keyword 3-12 
data server element (DSE) 1-2, 1-3, 2-4, 3-6 
data streaming protocol 

on PROTOCL = S parameter 2-11, 3-13 

on PROTOCL = S4 parameter 2-11,3-13 
DELETE screen command 4-7 
delete selection menu 4-13 
DEVCXA frame 5-2 
Device Configuration Frame 5-2 
DIAGNOSE X'80' 3-30 
DISK option on lOCP command 3-36 
display channel path menu 4-14 
display control unit menu 4-17 
display I/O device menu 4-20 
DISPLAY screen command 4-7 
display selection menu 4-10 



generating an lOCDS 

MVS version 1-18,2-23 

JCL examples 2-26 
stand-alone version 1-25, 4-32 
VM version 1-23, 3-1. 

examples 3-43 
VM/SP version 3-30 
generating an lOCDS on a new processor 
complex 4-32 

H 

HALT EXECUTION 3-41 
HCPRIO file 3-5 

I 

ID macro instruction 
description 2-15, 3-17 
example 2-15, 3-17 
format 2-15, 3-17 
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ID macro instruction (continued) 

introduction 1-4 

on configuration reports 5-3 

with MVS system generation 1-19 
ID1-, ID2= 2-15, 3-17, 5-3 
IGNORE option 

condition for coding 2-29 

on build lOCDS from cards menu 4-23 

on FARM parameter of EXEC statement 2-24 

on the lOCP command 3-34 
input to lOCP 

introduction 1-4 

lOCP macro instructions 2-2, 3-2 
integrated processor controller file 4-1 
invoking stand-alone lOCP 4-3 
lOCDS 

compatibility considerations 1-7 

configuration reports 2-28, 3-30, 5-1 

customer name 2-15, 3-17, 4-30 

generating an lOCDS 

MVS version 1-18,2-23 
stand-alone version 1-25, 4-23, 4-32 
VM version 1-23, 1-25, 3-1 
VM/SP version 3-30, 3-43 

initially defining 2-32, 3-47 

levels 1 -6 

overview 1-5 

read lOCDS from the processor controller file 
menu 4-27 

subsequently defining 2-33, 3-48 

write lOCDS to the processor controller file 4-29 

write-protecting 1-5 

370-XAmode 1-8 
lOCDSM frame 1-5,2-15,3-17 
lOCP 

card image input 1-4 

CMS lOCP command 3-30 

codes 3-46, 4-38 

comment card 2-2, 3-2 

compatibility considerations 1-7 

configuration reports 5-1 

console input 1-4 

dump function 4-36 

executing the MVS version 2-1 

executing the stand-alone version 4-1 

executing the VM version 3-1 

functions 2-23, 3-30 

introduction 1-1 

keyword values D-1 

levels 1-6 

macro instructions 2-2, 3-2 

messages 6-1 

MVS system generation 1-19 

return codes 2-31, 3-46 

specifying macro instructions 2-2, 3-2 

version number on the reports 5-3 

versions v, 1-18 

wait state codes 4-38 



lOCP (continued) 

370-XAmode 1-8 
lOCP command 3-32 

BOTH RPT option 3-35 

CDORPT option 3-35 

CD 1 RPT option 3-35 

DISK option 3-36 

IGNORE option 3-34 

LINECOUN option 3-36 

NOIGNORE option 3-34 

NOPRINT option 3-36 

NOTERM option 3-36 

NOWARN option 3-37 

NOW RT option 3-34 

NOWRTCDS option 3-34 

PRINT option 3-36 

RPTA option 3-35 

RPTAB option 3-36 

RPTAx option 3-35 

RPTB option 3-36 

RPTBx option 3-35 

TERMINAL option 3-36 

WABx option 3-35 

WARNING option 3-36 

WBx option 3-34 

WRT opfion 3-34 

WRTABx opfion 3-35 

WRTAx option 3-34 

WRTBx opfion 3-34 

WRTCDS option 3-34 
lODEVlCE macro instruction 

correspondence with DM K RIO file 3-3 

correspondence with HCPRIO file 3-5 

description 3-18 

examples 2-20, 3-28 

format 3-18 

introduction 1-4 

keyword values D-1 
lODEVlCE macro instrucfion, lOCP 

description 2-16 

format 2-16 

with MVS system generation 1-19, 2-16 
lODEVICE macro instrucfion, MVS system 

generation 1-19, 2-16 
I/O configuration 

definition requirements 1-1 

process 1-4 
I/O configuration data 

channel path configuration for a non-3084 1-2 

channel path configuration for a 3084 1 -3 

specifying 1-4, 3-2 
I/O device 

add menu 4-21 
I/O device display menu 4-20 
I/O devices 

alter menu 4-22 

configuration report 5-8 

delete menu 4-13 
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I/O devices (continued) 
display menu 4-20 
introduction 1-1 
specifying on lODEVICE macro instruction 2-16, 

3-18, D-1 
summary of restrictions 2-5, 3-7 



JCL statement (MVS version) 

introduction 1-18 
JCL statements (MVS version) 

generating an lOCDS 2-24 

introduction 2-1 

producing configuration reports 2-28 

K 

keyword values 

on lODEVICE and CNTLUNIT macro 
instructions D-1 



layout of menu screens 4-5 

levels of the IQCDS 1-6 

LINECOUN option on lOCP command 3-36 

LI NECOUNT option 

on FARM parameter of EXEC statement 2-26, 
2-29 
logical control unit 

CNTLUNIT macro instruction 2-10, 3-1 1 

configuration report 5-11 

definition 1-9 

examples 1-10, 1-12 

introduction 1-9 

restrictions 1-9 



M 



3-1 i 



-15 



macro instruction 
lOCP 

CHPID 2-6, 3-8 
CNTLUNIT 2-10, 
ID 2-15,3-17 
lODEVICE 2-16, 3- 
MVS system generation 
CHANNEL 2-6 
lODEVICE 
macro instructions 
listing of input 
rules for coding 
menu numbers (primary menu) 
MENU screen command 4-7 
menu screens 

add channel path 4-15 
add control unit 4-18 
add I/O device 4-21 
add selection 4- 1 1 



2-16 

B-l 

A-1 



4-8 



menu screens (continued) 
alter channel path 4-16 
alter control unit 4-19 
alter I/O device 4-22 
alter selection 4-12 
build lOCDS from cards 



4-23 



configuration reports 4-25 

delete selection 4-13 

display channel path 4-14 

display control unit 4-17 

display I/O devices 4-20 

display selection 4-10 

end IOC? 4-31 

layout of screens 4-5 

primary menu 4-8 

read lOCDS from the processor controller file 4-27 

service aid facility 4-25 

write lOCDS to the processor controller file 4-29 
messages 

DM SIC? prefix 6-46 
messages, lOCP 

ICP prefix 6-1 
method of execufing lOCP 

stand-alone version 4-32 
methods of executing lOCP 

MVS version 2-32 

VM version 3-47 
MODEL keyword 

on lODEVICE macro instruction 2-18, 3-23 
MSGl keyword 

on ID macro instruction 2-15, 3-17 
MSG2 key word 

on ID macro instruction 2-15, 3-17 
MVS System Generation 1-19 
MVS version of lOCP 

executing 2-23 

JCL statements 2-24, 2-28 

methods of executing 2-32 

overview 1-18 

using 2-1 
MVSCP 

relationship to lOCP 1-21 

N 

N keyword 

on SHARED parameter 2-12 

on TIMEOUT parameter 2-19 
N keyword value 

on SHARED keyword 3-14 

on TIMEOUT keyword 3-25 
NO keyword 

on IGNORE parameter 2-25 

on WRTCDS option 2-26 
NOIGNORE option on lOCP command 3-34 
NOPRINT option on lOCP command 3-36 
NOTERM option on lOCP command 3-36 
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NOWARN option on lOCP command 3-37 
NOWRT option on lOCP command 3-34 
NOWRTCDS option on lOCP command 3-34 



o 

OPTCHAN keyword 

on lODEVICE macro instruction 



2-17,2-24 



P 

PARM option 

producing configuration reports 2-28 
PARM options 

generating an lOCDS 2-1 
on EXEC statement 1-18, 2-1 
PATH keyword 

on CHPID macro instruction 2-6, 3-8 
on CNTLUNIT macro instruction 2-11, 3-12 
on lODEVICE macro instruction 2-18, 3-24 
power-on reset 1-5, 1-20, 1-24, 1-26 
preferred path 

introduction 1-13 

on lODEVICE macro instruction 2-18, 3-24 
primary menu 4-8 
print lOCDS configuration reports with Service Aid 

Facility 4-25 
PRINT option on lOCP command 3-36 
privilege class 3-40, 3-41 
processor complex 

channel path configuration 1-2, 1-3 
definition v 
side A 1-1 
side B 1-1 

3084 Processor Complex 1-1 
processor controller 

with MVS version Of lOCP 

generating an lOCDS 2-23, 2-27 
overview 1-18 

producing configuration reports 2-28 
with stand-alone version of lOCP 
executing lOCP 4-8 
with END command 4-31 
with read lOCDS from the processor controller 

file menu 4-27 
with write lOCDS to the processor controller file 
menu 4-29 
with the MVS version of lOCP 

overview 1-25 
with VM/SP version of lOCP 
generating an lOCDS 3-43 
overview 1-23 

producing configuration reports 3-31 
PROTOCL keyword 

on CNTLUNIT macro instruction 2-11, 3-12 



read lOCDS from the processor controller file 

menu 4-27 
replacing an lOCDS by using card-image input 4-33 
REPORT option 

condition for coding 2-29 

on PARM parameter of EXEC statement 2-28 
RESHOW screen command 4-7 
restarting lOCP 4-4 
return codes 2-31,3-46 
rotation algorithm 

examples 1-14 

introduction 1-14 
RPTA option on lOCP command 3-35 
RPTAB option on lOCP command 3-36 
RPTAx option on lOCP command 3-35 
RPTB option on lOCP command 3-36 
RPTBx option on lOCP command 3-35 
rules for coding macro instructions A-1 

S 

S keyword 

on PROTOCL keyword 2-11, 3-13 
screen commands 4-6 
service aid facility 4-25 
service support console 

executing lOCP 4-1 

input to lOCP 1-4 

starting lOCP 1-25,4-3 
SHARED keyword 

on CNTLUNIT macro instruction 2-11, 3-13 
side A 

definition 1-1 
side B 

definition 1-1 
single processor mode 3-38, 3-49 
specifying lOCP macro instructions 2-2, 3-2 
specifying I/O configuration data 1-4 
stand-alone version of lOCP 

methods of executing 4-32 

overview 1-25 

using 4-1 
starting and ending lOCP 4-3 
steps lOCP performs to build an lOCDS 4-35 
syntax of macro instruction 

CNTLUNIT 2-10 

ID 2-15 

lODEVICE 2-16 
syntax of macro instructions 

CHPID 2-6, 3-8 

CNTLUNIT 3-11 

ID 3-17 

lODEVICE 3-18 

rules for coding A-1 
SYSIML CLEAR 1-5, 1-20, 1-24, 1-26 
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SYSIN FILEDEF 3-32 
SYSPRINT FILEDEF 3-32 
system console 

executing lOCP 1-4,4-1 
input to lOCP 1-4 
starting lOCP 1-25,4-3 
system generation, MVS 
combined input deck 2-3 
macro instruction 
CHANNEL 2-6 
lODEVICE 2-16 
macro instructions 
CHANNEL 1-19 
lODEVICE 1-19 
relationship to lOCP 1-18 
system generation, VM 
macro instructions 

RCHANNEL 3-3, 3-5 
RCTLUNrr 3-3, 3-5 
RDEVICE 3-3, 3-5 
relationship to lOCP 1-23 
system status indicators 4-5 
S4 keyword 

on PROTOCL keyword 2-11,3-13 



TERMINAL option on lOCP command 3-36 
timeout function C-1 
TIMEOUT keyword 

on lODEVICE macro instruction 2-19, 3-25, C-1 
TYPE keyword 

on CHPID macro instruction 2-8, 3-10 

U 

uniprocessor 
definition v 
specifying channel set 2-7, 3-9 

UNIT keyword 

on CNTLUNIT macro instruction 2-13, 3-14 
on lODEVICE macro instruction 2-19, 3-25 

UNITADD keyword 

on CNTLUNIT macro instruction 2-13, 3-15 
on lODEVICE macro instruction 2-19, 3-26 



V 



versions of lOCP v, 1-18 
VM version of lOCP 

CMS lOCP command 3-30 

methods of executing 3-47 

overview 1-23 

using 3-1 



W 

WABx option on lOCP command 3-35 
wait state codes 4-38 

WARNING option on lOCP command 3-36 
WBx option on lOCP command 3-34 
write lOCDS to the processor controller file 

menu 4-29 
WRITE screen command 4-7 
write-protecting 1-5, 2-25, 3-33, 4-29 
WRT option on lOCP command 3-34 
WRTABx option on lOCP command 3-35 
WRTAx option on lOCP command 3-34 
WRTBx option on lOCP command 3-34 
WRTCDS option 

condition for coding 2-29 

on PARM parameter of EXEC statement 2-25 
WRTCDS option on lOCP command 3-34 
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Y B keyword 

on SHARED parameter 2-12 

Y keyword 

on SHARED parameter 2-12 
on TIMEOUT parameter 2-19 

Y keyword value 

on SHARED keyword 3-13 

on TIMEOUT keyword 3-25 
YB keyword value 

on SHARED keyword 3-14 
YES keyword 

on IGNORE parameter 2-24 

on WRTCDS option 2-25 

Numerics 

3084 

channel path selection 1-14 
3084 processor complex 

channel path configuration 1-3 
processors and channel paths 1-1 
370-XA mode 1-8 

channel path selection 1-13,1-14 
on a 3084 Processor Complex 1-14 
preferred path 1-13,1-14 
rotation algorithm 1-14 
control unit types 1-17 
input 1-8, 2-5, 3-7 
logical control units 1-9 

Special Characters 

* lOCP comment card 2-2, 2-24, 3-2, A-1 
** keyword value 

on PATH parameter 2-7 
*** keyword 

on CUNUMBR parameter 2-18 
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